[documentation manager hat on] Mark Stosberg <[email protected]> writes:
> I've accumulated several darcs tips I'd like to share, but I'm not > sure where the best place to put them is. The manual? The wiki? A > series of blog posts? First: anywhere is better than nowhere. Even if I don't like blogs, I'd rather you put it on a blog than leave it in your head. (I'd prefer the wiki to a blog, because then articles can be updated by others if the original author goes AWOL.) A lot of the manual is out of date, and for that reason alone I suggest you avoid it (for now, at least). I *think* my long-term goal is to migrate everything from the manual into internal docstrings or the wiki, and work out a way to automatically generate an attractive manual from those remaining two sources. > Let's start with a specific case. Where could these practical uses for > "darcs changes" best be shared? > > Reviewing Recent Changes > ------------------------ > [...] As this is a workflow, I think it fits best into the wiki. Specifically, I think it'd be an ideal section for the Getting Started article (which badly needs an overhaul). _______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
