[drupal-docs] comments

[Anisa]

But you know, there is no real reason why people can't be a little bit 
more free with the V2 handbook as it stands.  Just put a note that it's 
a test page.

Anisa.

Charlie Lowe wrote:

>LOL
>
>Well, there's some discrepency over what the current workflow is for 
>revising the book with V2 and the wiki going on, too. I'm just following 
>Djun's lead and the previous process and revising in the existing 
>handbook and thinking all the documentation should go there.
>
>If we were going to go with that, I do think we could use a space for 
>posting drafts. By that I mean, sometimes we might like to get feedback 
>on a really rough draft before replacing the original book page. I know 
>I would. Plus, having a place to post drafts means that a book page 
>isn't down because a new version is in the moderation queue waiting to 
>be approved (this is another issue: not sure we need a moderation queue 
>so much as a notification engine for revisions and new book pages so 
>that book maintainers know when changes have been made).
>
>The wiki for me is out because
>
>(1) I think the process should stay on drupal.org (eat your own dog 
>food, makes the process more transparent to the community, easier to 
>keep track of when everything is on drupal.org)
>
>(2) the advantage of wiki markup is negated since what goes in the 
>handbook should have HTML formatting.
>
>Two spaces for this on drupal.org: Forums or Project Issues. Now I've 
>used project issues for documentation construction on http://osddp.org/. 
>I tend to like using threaded comments for discussion of text over just 
>the project issue without it. Plus, if a draft is posted as a node in a 
>forum, it "looks" like it would in the handbook (the project issues have 
>a different display); the visual similarity helps a little bit, I think. 
>So for me, I'd probably want to post something to the Documentation 
>Forum, then notice the doc list for feedback. Easy enough for anyone to 
>post comments or revisions in the comment space.
>
>Anisa wrote:
>  
>
>>Hm.  Well, I don't personally think it's an efficient workflow to do 
>>everything on the wiki and then transfer it over.  It's not a 
>>particularly efficient kind of wiki.  I don't make it because I think it 
>>will be better, but just to provide a place in case someone wants to use it.
>>
>>The current workflow is... what, precisely?
>>
>>    
>>
>
>  
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050518/5dc09c44/attachment.htm