Jason Warner wrote:


On Fri, Feb 22, 2008 at 2:42 PM, Hernan Cunico <[EMAIL PROTECTED] <mailto:[EMAIL PROTECTED]>> wrote:

    "Need update" would be something like moved the content from prev
    release but not yet finished. Or worked on some brand new content
    but still need to update it to reflect the latest changes on the
    server ( think of it as if you started before Geronimo was released,
    then you would have a bunch of SNAPSHOTs all over the place).
    If there is anything on the Need update column then there should not
    be a green check mark on the status column. Does this make sense?
    what do others think?

Your explanation of "Need update" seems to be about what I thought it was. Thanks for the clarification.

    As for "...still needs someone who knows what the article is talking
    about to update..." I would hope that the people who jumps into any
    of those subjects can follow it through all the way. Otherwise this
    table won't help us figure out how complete the content really is.


I understand your concern, but there are many topics in the 2.0 documentation that are large and fairly encompassing. I don't think it unreasonable for someone to move the document over and fix what they're able to, but then mark it as Need update if they're not comfortable with their knowledge on a certain subject. I think it'll be very difficult to port all this documentation over if we wait for someone who's able to verify every thing on a page to take responsibility for it. I'm not advocating people just blindly port pages over and mark it as Need update without attempting to verify what they can. I just don't want people to be turned off from helping with documentation just because they're not a power user.


So, how do we keep track of such topics then. I think looking into previous 
docs and updating the content is a great start for those that are not experts.

By following through I mean just that, if you don't know the entirely topic 
bring the question forward (dev@, IRC, jira, phone, smoke signals, anything 
that works) What a best way to learn a new topic than following it through from 
start to end. I find this very encouraging :D

Cheers!
Hernan



    Cheers!
    Hernan

    Jason Warner wrote:
     > Hernan,
     >
     > What's the "need update" column for on the 2.0 Update status
    page?  Is
     > that to mark a page that is moved over but still needs someone
    who knows
     > what the article is talking about to update it based on 2.1?
     >
     >
     > On Thu, Feb 21, 2008 at 5:04 PM, Hernan Cunico <[EMAIL PROTECTED]
    <mailto:[EMAIL PROTECTED]>
     > <mailto:[EMAIL PROTECTED] <mailto:[EMAIL PROTECTED]>>> wrote:
     >
     >     Hi All,
     >     an interesting thing happened twice already this week. Given the
     >     number of doc contributions that started to flow recently
    (THANKS TO
     >     ALL OF YOU CONTRIBUTING) we ended up having, or just about to
    have,
     >     some overlapping.
     >
     >     Talking with some of the folks we thought it would be a good
    idea to
     >     put together some sort of table or a list with the topics and who
     >     was working on them. So, I updated the 2.1 doc home page and
    added a
     >     few more pages to help us figure out who is working on what. This
     >     should also help bring in new contributions.
     >
     >
     >     Here is the page, I already started to put some names there. Pls
     >     chime in and update the info with the content you are working on.
     >
     >     http://cwiki.apache.org/GMOxDOC21/documentation-development.html
     >
     >     What to others think?
     >
     >     Cheers!
     >     Hernan
     >
     >
     >
     >
     > --
     > ~Jason Warner




--
~Jason Warner

Reply via email to