-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
77 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
docSystems.adoc | ||
|
||
|
||
- - - | ||
_2023-10-18 12:03 chat w SteveZ_ | ||
|
||
I associate hierarchy with | ||
|
||
- The organization of a book, | ||
- logical sequence of topics, | ||
- simple to complex | ||
- (book, chapter, verse,..) | ||
|
||
- Tree of life (sub-class relations) Kingdom,Phylum,C,O,F,Genus,Species https://images.squarespace-cdn.com/content/5f02d28f35d64d2a5022eeb1/ed2fcad4-bf94-494e-90cc-647d8943a630/30.png?format=1500w&content-type=image%2Fpng[] | ||
|
||
|
||
- - - | ||
I'd appreciate your reactions to some thoughts I had about the Grouper Survey Initial Recommendations: https://docs.google.com/document/d/1uWRomgUflT6Ec03vo-tL795XUUr2HdpU0WrVLZC-Yvs/edit?usp=sharing[] | ||
|
||
Page Warnings | ||
- Experimental | ||
- Since | ||
- Deprecated | ||
- Obsolete | ||
- Replaced By | ||
- Outdated | ||
|
||
|
||
*- Steve Zoppi -* | ||
|
||
I have a similar "sense" of those taxonomies from the survey feedback too... | ||
|
||
I think that the missing "prescription" is how to maintain documentation in alignment with the version - so right now (the way you've written it up) it lacks the information hierarchy ands presumes "tagging" may be the primary means of categorizing a given article or document. | ||
|
||
The thing I'm wrestling with (in my head) is | ||
- the _information hierarchy_ that encapsulates _each group_ of documents. | ||
|
||
I don't have good answers (yet) but I'm considering that there needs to be | ||
- _two branches_ (at least) of hierarchy: | ||
(1) Global/Persistent Concepts and Facilities artifacts/documents/articles | ||
(2) Ephemeral/Version-bound artifacts/documents/articles. | ||
|
||
- - - | ||
_2023-04-06 11:18:07 Setting up evolveum-like doc site_ | ||
|
||
https://docs.evolveum.com/about/jekyll-environment/[] <- install, config, build, run jekyll site + | ||
|
||
*- local jekyll instance of Evolveum Docs running: -* | ||
|
||
http://localhost:4000/ + | ||
|
||
- - - | ||
_2023-04-04 11:28:40 adding commenting to a static site_ | ||
|
||
https://github.com/eduardoboucas/staticman[] <- open source commenting system + | ||
https://staticman.net/docs/index.html[] + | ||
https://mademistakes.com/mastering-jekyll/static-comments-improved/[] <- staticman plus + | ||
|
||
https://averagelinuxuser.com/static-website-commenting/[] + | ||
https://docs.evolveum.com/about/jekyll-environment/[] + | ||
|
||
https://remark42.com/docs/getting-started/installation/[] + | ||
|
||
https://simondosda.github.io/posts/2021-09-13-blog-github-pages-1-introduction.html[] + | ||
... + | ||
https://simondosda.github.io/posts/2021-09-17-blog-github-pages-5-comment-1.html[] + | ||
https://simondosda.github.io/posts/2021-09-18-blog-github-pages-6-comment-2.html[] + | ||
|
||
- - - | ||
_2023-04-03 13:11:12 evolveum approach to documentation_ | ||
|
||
https://docs.evolveum.com/about/writing-documentation/[] <- ref manual for Evolveum Documentation + | ||
https://docs.evolveum.com/about/jekyll-environment/[] <- setting up jekyll | ||
https://github.com/Evolveum/docs/[] <- Source Code of Evolveum Documentation Site + | ||
https://docs.evolveum.com/about/asciidoc/[] + | ||
|
||
- - - |