ANN [Grok-doc] Maintaining the Grok Community Documentation

[Sebastian Ware]

Hi All!

 >> No framework is better than it's documentation <<

As you might have noticed, we have created a team to organise the  
maintenance of Grok Community Documentation. Our goal isn't to add all  
the missing documentation, but rather to assist those who want to help  
doing so. The team consist of

Sebastian Ware
Tim Cook
Steve Schemchel

Our goal is to:

1 Organise and assist in the maintenance of Grok Community Documentation
2 Provide some level of support to those who write community docs
3 Maintain a mailing list where discussions about writing and  
maintaining docs is the nr 1 priority

http://mail.zope.org/mailman/listinfo/grok-doc

Why yet another mailing list? The idea is to focus on documentation. A  
thread in this mailing list won't get burried by dev-threads and vice  
versa. We also want to lower the bar of entry into the Grok community.  
You don't have to be a stellar developer to ask or answer questions on  
this list. Lastly, and most importantly, we want to make it painfully  
obvious if activity in the docs department is lower than acceptable...

We will be posting feedback on [grok-dev] if we need help with  
reviewing, or mentoring someone who is writing documentation, but  
unless you are a very busy person, please subscribe to the [grok-doc]  
mailing list too.

http://mail.zope.org/mailman/listinfo/grok-doc

**
*** How to get involved...
**

1 Start by subscribing to [grok-doc]:
  http://mail.zope.org/mailman/listinfo/grok-doc

2 Check if there is a document that needs to be reviewed:
  https://blueprints.launchpad.net/grok?searchtext=doc-
  Info is available on the Blueprint Whiteboard
  https://blueprints.launchpad.net/grok/+spec/doc-permissions

3 Post a message on [grok-doc] with your Launchpad username and a link  
to the Blueprint you want to edit/review and start working on it. The  
grok-doc team will add you as "assignee" on the Blueprint
  NOTE: You can start reviewing the content immediately, don't wait  
for us!

4 Browse [grok-docs-review] for some info on the review process
  https://blueprints.launchpad.net/grok/+spec/grok-docs-review

Mvh Sebastian
_______________________________________________
Grok-dev mailing list
Grok-dev@...
http://mail.zope.org/mailman/listinfo/grok-dev

[Reinout van Rees]

On 2009-07-01, Sebastian Ware <sebastian@...> wrote:
>
> http://mail.zope.org/mailman/listinfo/grok-doc

I've just send a request to gmane to carry this mailinglist, too.  That's
where I've got a newsreader for :-)

/me doesn't guarantee that gmane will do it, but I'll just wait patiently.

Reinout

--
Reinout van Rees - reinout@... - http://reinout.vanrees.org
Software developer at http://www.thehealthagency.com
"Military engineers build missiles. Civil engineers build targets"

_______________________________________________
Grok-dev mailing list
Grok-dev@...
http://mail.zope.org/mailman/listinfo/grok-dev

[Steve Schmechel]

I don't know much about gmane, but I have set up Nabble to archive the new grok-doc list as well.

http://n2.nabble.com/Grok-Documentation-f3214448.html

The grok-dev list has been available on Nabble since its inception at:
http://www.nabble.com/Grok-f28342.html

Unfortunately, the lists are being handled by separate versions of the Nabble application ( -dev uses the old Nabble and -doc uses the new).  So the interface is slightly different and, if you want to reply through the service, you need an appropriate Nabble account for either list.

It would be nice to include a link or an embedded view of the doc list, similar to the dev list at:

http://grok.zope.org/community/grok-web-forums

Let me know what you think, because I am not sure who has authorization on the Grok website to do that.

Thanks,
Steve

--- On Mon, 7/6/09, Reinout van Rees <reinout@...> wrote:

> From: Reinout van Rees <reinout@...>
> Subject: Re: [Grok-dev] ANN [Grok-doc] Maintaining the Grok Community Documentation
> To: grok-dev@...
> Date: Monday, July 6, 2009, 3:39 AM
> On 2009-07-01, Sebastian Ware <sebastian@...>
> wrote:
> >
> > http://mail.zope.org/mailman/listinfo/grok-doc
>
> I've just send a request to gmane to carry this
> mailinglist, too.  That's
> where I've got a newsreader for :-)
>
> /me doesn't guarantee that gmane will do it, but I'll just
> wait patiently.
>
> Reinout
>
> --
> Reinout van Rees - reinout@...
> - http://reinout.vanrees.org
> Software developer at http://www.thehealthagency.com
> "Military engineers build missiles. Civil engineers build
> targets"
>
> _______________________________________________
> Grok-dev mailing list
> Grok-dev@...
> http://mail.zope.org/mailman/listinfo/grok-dev
>

     
_______________________________________________
Grok-dev mailing list
Grok-dev@...
http://mail.zope.org/mailman/listinfo/grok-dev