cuetorials.com
just-the-docs
Our great sponsors
cuetorials.com | just-the-docs | |
---|---|---|
27 | 17 | |
113 | 7,002 | |
-0.9% | 2.5% | |
4.1 | 8.4 | |
27 days ago | 5 days ago | |
CUE | SCSS | |
BSD 3-clause "New" or "Revised" 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.
cuetorials.com
-
HCL: Toolkit for Structured Configuration Languages
I have a website I maintain, many people tell me it has helped them
https://cuetorials.com
-
Ask HN: Comment here about whatever you're passionate about at the moment
CUE(lang), because devops & yaml engineering has gotten out of hand
I maintain https://cuetorials.com and am heading up the CUE sig-infra group for the time being
- That's a Lot of YAML
-
Ask HN: Who needs vendors, and vendors, who needs customers?
If you need help with CUE(lang), we maintain https://cuetorials.com and have experience helping others adopt it at their companies
email is in my HN profile, same handle on GitHub and X
- Learn you some CUE for a great good
-
Ask HN: Which Python or Rust-based static site generators to use as of 2023?
If you are more focused on the devops part, and not implementing a static site generator, then go with Python. For our static sites we use Hugo + GH Actions + Kubernetes (since we have a cluster anyway). There is not really any code involved here (example: https://github.com/hofstadter-io/cuetorials.com)
I'm personally interested to try https://docs.dagger.io/sdk/python/ for something. I used the CUE sdk, but it is effectively deprecated at this point. I use a mix of base, make, python, and CUE fro most devops / devex stuff now. Dagger makes it so local & CI stuff runs the same.
- Cue Wins
- Ask HN: Do you have something you continually work on for years?
-
Ask HN: How to find the right tech angel investor for new programming platform?
yup, I'm betting the proverbial ranch on CUE :]
I also maintain https://cuetorials.com
-
hof: The High Code Framework (low-code for devs), a flexible data modeling & code generation system
I also maintain https://cuetorials.com, bet the farm on CUE or something like that :]
just-the-docs
-
Gojekyll – 20x faster Go port of jekyll
I think GitHub Pages only supports a whitelist of plugins, so you might have some more difficulties solving it well without any plugins. I use Netlify for my site, which does support arbitrary plugins.
One quick way to make it faster is to include that "_includes/nav.html" only in a nav.html, and then use an iframe to load that on every page, or something like that.
Anyway, I'm not the first to notice this it seems, although even "twice as fast" would still be quite slow: https://github.com/just-the-docs/just-the-docs/issues/1323
-
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.
-
Looking for advice: does any one use GitHub/GitClassroom to store and mange their course content?
So the basic idea is I use the Jekyll site generator (which is already built into GitHub pages, but you can also install locally), and this is the theme I use: https://just-the-docs.github.io/just-the-docs/
- 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.
-
Compiling findings to website
The pages are written in markdown and the site has an in-built search feature. I am using the https://github.com/just-the-docs/just-the-docs jekyll theme.
-
Atlassian Patch Critical Confluence Hardcoded Credentials Bug
The only people that like confluence have Stockholm syndrome. I'd argue that a wiki is the old people way of thinking. In most orgs a wiki is where data goes to die but some asshole keeps throwing data in there to appease some other asshole. I rather search slack, https://github.com/just-the-docs/just-the-docs, project boards in github, anything is better than confluence and I couldn't agree more that confluence search is the biggest piece of shit ever, it's worse than useless, it wastes your time.
-
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.
What are some alternatives?
vector - A high-performance observability data pipeline.
Read the Docs - The source code that powers readthedocs.org
juicefs - JuiceFS is a distributed POSIX file system built on top of Redis and S3.
MkDocs - Project documentation with Markdown.
cue - The home of the CUE language! Validate and define text-based and dynamic configuration
jekyll-theme-chirpy - A minimal, responsive, and feature-rich Jekyll theme for technical writing.
cue - CUE has moved to https://github.com/cue-lang/cue
Docusaurus - Easy to maintain open source documentation websites.
hof - Framework that joins data models, schemas, code generation, and a task engine. Language and technology agnostic.
jekyll-docker - ⛴ Docker images, and CI builders for Jekyll.
VuePress - 📝 Minimalistic Vue-powered static site generator
jekyll-theme-hamilton - A minimal and beautiful Jekyll theme best for writing and note-taking.