I have lately been thinking about contributing to CTAN. This question has many nice links in that regard.
However: I've noticed that most (if not all) of the packages have the same documentation layout. So I started doing some research on this and came across Documented LaTeX Format, and I had a few questions regarding how it's commonly applied.
This answer suggests that you don't have to document a package using
docstrip, and I haven't come across anywhere it says that it has to be this format.
CTAN's dtx tutorial is a nice introduction to the syntax, and I think I got that part covered. My specific questions are:
What I would like to know
- Is it common to write documentation separately from your file (illiterate(?))?
- If you ever wrote a package that could be published to CTAN, how did you go about documentation?
- Anything related to this that I should know about?
- The TeX FAQ mentions "sty2dtx" which "attempts to create a dtx file from a ‘normal’ sty file with comments.". Is this something you've tried? Does it work well?
- What are good alternatives for generating
Anything related to this that I should know is very well appreciated.
Edit: I could mention that I would only write packages that are related to statistics, math, physics and the like.