adr-tools
log4brains
| adr-tools | log4brains | |
|---|---|---|
| 3 | 6 | |
| 4,679 | 1,152 | |
| - | - | |
| 0.0 | 7.8 | |
| 8 months ago | 18 days ago | |
| Shell | TypeScript | |
| GNU General Public License v3.0 or later | Apache License 2.0 |
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.
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.
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)
What are some alternatives?
pandoc-templates - An opinionated set of Pandoc templates and scripts for converting markdown to DOCX manuscripts that adhere to William Shunn's Proper Manuscript Format guidelines using Pandoc.
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
udoxy - Guidelines and script (bash) for generic standalone code documentation
mm-docs-template - Template to use with mm-docs
github-action-markdown-link-check - Check all links in markdown files if they are alive or dead. 🔗✔️
ts-doc-gen-md - Generates documentation in github flavored markdown for typescript libraries.
jellyfin-docs - Documentation for Jellyfin
mdSilo-app - Lightweight Knowledge Base and Feed Reader.
docs - Rundeck documentation
slant - Beautiful static documentation for your API