log4brains
adr-tools
log4brains | adr-tools | |
---|---|---|
6 | 3 | |
1,061 | 4,404 | |
- | - | |
0.0 | 0.0 | |
3 months ago | 9 days ago | |
TypeScript | Shell | |
Apache License 2.0 | GNU General Public License v3.0 or later |
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.
log4brains
-
A practical overview on Architecture Decision Records (ADR)
There is an interesting win-win tool called log4brains, that can turn your markdown into a static website. It's also integrated into MADR template. I havenโt had time to try them yet, but it's in my backlog.
-
Can't bring myself to produce code any more, any ideas to help?
I'm a solution architect in my current job, and I love it because I still get to solve technical problems and help/mentor more junior developers but I don't really write code anymore (except on minor occasions and it's mostly by choice). The tradeoff is I have to write docs and make presentations, but I learned how to do that easily enough.
- Build some good documentation habits in your team with ADRs (Architecture Decision Records) and their go-to tool: Log4brains
- Document your project by logging your decisions chronologically with ADRs (Architecture Decision Records)
- Log4brains: Document your projects by logging your decisions chronologically with ADRs (Architecture Decision Records)
- Document your projects by logging your architecture decisions chronologically with ADRs (Architecture Decision Records)
adr-tools
-
What tools do you use to plan software features?
For architectural decisions I have used this in the past: https://github.com/npryce/adr-tools
- More persistent and less frenetic communication: alternatives to Slack
-
Documenting Software Architecture Decisions
๐ This approach is becoming more popular. It's a great way to document decisions and, for many teams, is a core part of their documentation bundle. ADRs don't take very long to put together, but they are incredibly useful to look back on, to help tell stories about how/why things changed, etc. Definitely recommended if you're not using them already, and Nat Pryce's adr-tools tool is an easy way to get started.
What are some alternatives?
vscode-front-matter - Front Matter is a CMS running straight in Visual Studio Code. Can be used with static site generators like Hugo, Jekyll, Hexo, NextJs, Gatsby, and many more...
standard-readme - A standard style for README files
documentalist - :memo: A sort-of-static site generator optimized for living documentation of software projects
jellyfin-docs - Documentation for Jellyfin
mdSilo-app - Lightweight Knowledge Base and Feed Reader.
github-action-markdown-link-check - Check all links in markdown files if they are alive or dead. ๐โ๏ธ
mm-docs-template - Template to use with mm-docs
udoxy - Guidelines and script (bash) for generic standalone code documentation
prpl - Lightweight library for building fast static sites
docs - Rundeck documentation
slant - Beautiful static documentation for your API
EMBA - EMBA - The firmware security analyzer