Any Thoughts on API Documentation So Far?

Note: This discussion was imported from Loomio. Click here to view the original discussion.

This is what I’ve started so far with the documentation.

I feel the documentation should be layout-based as opposed to control-flow-based (I guess that’s how you would describe the other way of doing it) since a web page is visual.
Though hacking Diaspora* I found myself asking “How do I change X? Where are the controls for X in the code?”

Any other thoughts?

Hm, I’m not sure what “API” you want to document there, so I can’t say much more.

The other thing is that we’re currently investigating to move the wiki to or something similar, not sure if it’s worth the effort to start a whole new section in the old one.

Btw. one doesn’t use a-tags as anchors anymore but just plain IDs, see :wink: