programming.dev

9,325 readers
327 users here now

Welcome Programmers!

programming.dev is a collection of programming communities and other topics relevant to software engineers, hackers, roboticists, hardware and software enthusiasts, and more.

The site is primarily english with some communities in other languages. We are connected to many other sites using the activitypub protocol that you can view posts from in the "all" tab while the "local" tab shows posts on our site.

🔗 Site with links to all relevant programming.dev sites

🟩 Not a fan of the default UI? We have alternate frontends we host that you can view the same content from

ℹ️ We have a wiki site that communities can host documents on

⚖️ All users are expected to follow our Code of Conduct and the other various documents on our legal site

❤️ The site is run by a team of volunteers. If youre interested in donating to help fund things such as server costs you can do so here

💬 We have a microblog site aimed towards programmers available at https://bytes.programming.dev

🛠️ We have a forgejo instance for hosting git repositories relating to our site and the fediverse. If you have a project that relates and follows our Code of Conduct feel free to host it there and if you have ideas for things to improve our sites feel free to create issues in the relevant repositories. To go along with the instance we also have a site for sharing small code snippets that might be too small for their own repository.

🌲 We have a discord server and a matrix space for chatting with other members of the community. These are bridged to each other (so you can interact with people using matrix from discord and vice versa.

Fediseer

founded 2 years ago

ADMINS

Talo: a CLI tool to manage your ADRs, RFCs, and other design documents (github.com)

submitted 1 year ago by canpolat to c/showoff

0 comments fedilink

I created a CLI tool that can be used to create, update, list and export (to HTML) software design documents like Architecture Decision Records (ADR), Requests for Comments (RFC), and any other custom document types you may have.

It's already trivial to create a Markdown file from an existing template and start typing. And, you will have to do most of the job in your favorite editor anyway. Here is what talo brings to the table:

You can list all your documents displaying their titles and latest statuses.
You can export your documents to HTML. talo will link documents to each other so that when a document supersedes another, you will be able to navigate between the two via hyperlinks.
You are not limited to ADR and RFC. You can create your own document type(s) and use talo to manage them.

The demo GIF in the README showcases some of the use cases. Advanced topics like creating your own document types are also documented in the README.

talo is free and open source.

If you already have .NET SDK 8.0, you can install it as a dotnet tool (dotnet tool install --global Canpolat.Talo). Otherwise, you can download the single file binary executable for your system (Linux/Windows).