Open tonini opened 12 years ago
I've talked to @jone a bit about the bundle list. It's true, the current solution is not working and we need a better way to document them. We did not reach a conclusion what path to take so suggestions are welcome.
I'm thinking about something like a "README.md" in every bundle folder. We could write up a simple script, which collects these and publishes the information on the website.
@tonini @jone what do you think?
@senny @jone I like the "README.md" file per bundle folder solution. +
+1 on readme file per bundle and publishing it. could we also generate binding documentation dynamically, at least for ergonomic? i think this could help new users.. just a thought :)
First step would be to update or add readme files for all bundles. I think the readme file should be separated in different parts like name, author, description, external libraries etc .. If we use markdown for the readme file (as currently) it would be very easy to use jekyll as a static html site generator.
With all these readme files plus informations, I would like to write a generator which creates nice bundle presentation pages, so ppl haven't to read the source to get an idea what's all possible with cabbage and the internal bundles.
@jones idea about a generated binding documentation is really good. +1 for it!
@senny The binding documentation is already available through the generated cheat-sheet. But in case of the bundle list and the "README.md" file per bundle I would like to build it.
Add a "README.md" per bundle
Online bundle documentation
/cc @jone
@tonini go for it :+1: I think we can use the GitHub page to incorporate the online documentation. If we are going down this path, there should be scripts to automatically update the GitHub page form the README.md
files within the bundles.
Regarding the structure I'm not sure yet. Let's just get started and see where it'll take us. Suggestions welcome :smile_cat:
@senny Great! I get back to you when I have something to show.
The list of the currently available emacs bundle in the readme file is a bit brittle. What if we create a bundles.md file and list all bundles there?