Worldwide TG2 DocSprint Sept. 25-27

[percious]

TurboGears will be sprinting to improve our documentation in
preparation for our up-coming 2.1a1 release. We could use all the
help we can get, so if you have time to review existing docs, or
figure out one little piece of TG and update or contribute to our
docs, we'd love to have you, and help you get going with TG2.

Michael Pedersen from the TG team has spent the last month or so
reviewing every doc in detail, restructuring, reorganizing, and noting
things that need to be done. He has created a document here:
http://web.icelus.tzo.com/~marvin/tg2/todo.html that we will be using
for our sprint. If something there piques your interest, please don't
hesitate to take it on. I'm hoping that we can hammer out about 1/2
the list.

The sprint will work like this: Friday night, the TG2 team will
triage the todos, and categorize them by difficulty. Since this (like
all the TG sprints) is a worldwide sprint, we will be active on irc:
#turbo...@irc.freenode.net for the entire weekend. Anyone is of
course welcome to participate in any way they like, but I will be at
Bivio, in Boulder, CO at 9am on Saturday to start hammering out some
docs. This would be the best time for people in the TG community to
collaborate. Sunday there may be some "residual" sprinting on IRC,
but unless there is a huge desire for a second in-person day I'll be
working from home.

So, I hope to see you there!

cheers.
-chris

[Christoph Zwerschke]

percious schrieb:

> TurboGears will be sprinting to improve our documentation in
> preparation for our up-coming 2.1a1 release.

Great! I'll try to join in that weekend.

-- Christoph

[Michael Pedersen]

And, as I'm sure will shock everybody, I will be there as well. I'm sorry my lack of activity the past week and a half. Getting that todo list done was so huge, I just felt like I needed to take a short break. I'll be getting back to work on the docs tomorrow night.

--
Michael J. Pedersen
My IM IDs: Jabber/pede...@icelus.tzo.com, ICQ/103345809, AIM/pedermj022171
         Yahoo/pedermj2002, MSN/pederm...@hotmail.com

[Michael Pedersen]

I've been holding off until a closer time before posting this bit.

Anybody who is participating, please take the following steps in advance, as it will make things much faster for me to incorporate your changes:

http://web.icelus.tzo.com/~marvin/tg2/building_docs.html

Following through with the instructions in that document, including forking my tg_2_1_docs repository on bitbucket, means that you will have all the latest changes, and be easily able to pull in changes that I incorporate throughout the day. All in all, this looks to be a great day for getting documentation updated.

I look forward to seeing everybody there!

[percious]

I also wanted to mention that members of the TG team should be online
for the majority of Friday in order to facilitate setup. If you hop
in to irc://#turbo...@irc.freenode.net you should find us.

cheers.
-chris

On Sep 21, 8:48 pm, Michael Pedersen <mjpe...@gmail.com> wrote:
> I've been holding off until a closer time before posting this bit.
>
> Anybody who is participating, please take the following steps in advance, as
> it will make things much faster for me to incorporate your changes:
>
> http://web.icelus.tzo.com/~marvin/tg2/building_docs.html
>
> Following through with the instructions in that document, including forking
> my tg_2_1_docs repository on bitbucket, means that you will have all the
> latest changes, and be easily able to pull in changes that I incorporate
> throughout the day. All in all, this looks to be a great day for getting
> documentation updated.
>
> I look forward to seeing everybody there!
>
> --
> Michael J. Pedersen

> My IM IDs: Jabber/peder...@icelus.tzo.com, ICQ/103345809, AIM/pedermj022171
>          Yahoo/pedermj2002, MSN/pedermj022...@hotmail.com

[Christoph Zwerschke]

Michael Pedersen schrieb:

> Anybody who is participating, please take the following steps in
> advance, as it will make things much faster for me to incorporate your
> changes:
>
> http://web.icelus.tzo.com/~marvin/tg2/building_docs.html

I noticed you're still recommend cloning from mramm's repository.
You should change this so people start cloning from the new official
repositories located at http://bitbucket.org/turbogears/
(tg-dev, tgdevtools-dev and tg-docs for the 2.1 branch).

-- Christoph

[Michael Pedersen]

Ah, just noticed this was from the same person as the pull request I got.

Have fixed this, and merged your windows building updates.

[Christoph Zwerschke]

Michael Pedersen schrieb:

> Ah, just noticed this was from the same person as the pull request I got.
>
> Have fixed this, and merged your windows building updates.

Thanks, but you referenced the tg-docs repo instead of tg-dev when
installing the TG 2.1 branch.

The tg-docs repo is needed only later (for the sprint I think we need to
clone from your tg-docs branch, not from the official one - later we can
merge your branch back to the official repo).

Btw, we should also recommend installing tg-devtools along with tg. This
will automatically install SQLAlchemy.

Shall I send you another patch or do you want to fix it?

-- Christoph

[Michael Pedersen]

Actually, I'll ask if you wouldn't mind doing a patch for it please. For some reason, I'm just not getting this right, and my brain is not processing it correctly.