docs-sample
just-the-docs
Our great sponsors
docs-sample | just-the-docs | |
---|---|---|
1 | 15 | |
0 | 5,705 | |
- | 5.2% | |
10.0 | 8.5 | |
4 months ago | 3 days ago | |
Ruby | SCSS | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
docs-sample
-
Keep your diagrams updated with continuous delivery
The full pipeline configuration can be seen here.
just-the-docs
-
Having the rules and mechanics easily accessible in a webpage/site.
If it can help, there was a commenter earlier who suggested trying out a Doc-style github page that you can easily fork. It also has its own built-in search. Comment here. Github page here.
- Is legit to use Github pages for non-coding purposes?
- Keep your diagrams updated with continuous delivery
-
Open Source Like
That's certainly an option. Games like Liminal Horror and Into the Dungeon Revived host versions on GitHub. You can then render it to a GitHub.io page using something like Just the Docs.
-
Ask HN: What do people use for documentation sites these days?
https://pmarsceill.github.io/just-the-docs/
Especially if you're already familiar with Jekyll. Bonus points for being able to deploy on GitHub Pages!
-
Tags-based documentation build (contextual documentation)
You can use 'Just the Docs' (https://github.com/pmarsceill/just-the-docs) for documentation - it's a Jekyll-based theme for documentation and has built-in search.
-
Which tools did you use to design yours cloud architecture ?
Yeah, itβs just a visualization for the configuration in the repository. I also have a repository that utilizes GitHub Pages hosting for more generalized account level documentation and diagrams (Just the Docs is a great theme for this).
- Ask HN: What are you using for public documentation these days?
-
Testing github pages with remote theme locally
I am using github-pages with a remote theme (just-the-docs) to host one of my projects documentation. I wanted a way to test everything locally, without having to install anything on my machine. I found lots of resources, including this dev.to post, but none worked as expected. My biggest problems were:
-
Building a Documentation Workflow in Rails
This creates a /docs directory containing a minimal Jekyll site (the default is a blog theme called Minima). You can use this as the base for your custom Jekyll docs site. Alternatively, you can install a docs theme, such as just-the-docs, which comes with sidebar navigation and site search functionality.
What are some alternatives?
MkDocs - Project documentation with Markdown.
Read the Docs - The source code that powers readthedocs.org
jekyll-theme-chirpy - A minimal, responsive and feature-rich Jekyll theme for technical writing.
Docusaurus - Easy to maintain open source documentation websites.
typedoc - Documentation generator for TypeScript projects.
jekyll-theme-hamilton - A minimal and beautiful Jekyll theme best for writing and note-taking.
jekyll-docker - β΄ Docker images, and CI builders for Jekyll.
mdBook - Create book from markdown files. Like Gitbook but implemented in Rust
docsify - π A magical documentation site generator.
juicefs - JuiceFS is a distributed POSIX file system built on top of Redis and S3.
LearnJavaForFTC - This is for learning Java for FTC
VuePress - π Minimalistic Vue-powered static site generator