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: -
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://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/