Skip to main content
Welcome guest. | Register | Login | Post

Collaboration Guidelines: Fourth Draft (and hopefully, the last one)

9 replies [Last post]
Gustavo's picture
Offline
Joined: 2006-09-11

Hello!

Here's the fourth working draft of the collaboration guidelines: http://test.getgnulinux.org/temp/collaboration_guidelines/draft4/

What do you think about it? Also, please tell me if I made any mistake writing in English.

The source is available from the svn repo http://svn.getgnulinux.org/cg_en

By the way, I'm not from Toulouse. I don't know why it's transformed that way.

Cheers!

EDIT: Corrected the URL of the draft.

Bjwebb's picture
Offline
Joined: 2007-03-01
Quote: when contributing in
Quote:

when contributing in GNU/Linux Matters

Might sound better as "contributing to".

Quote:

There exists several ways to support GNU/Linux Matters

exists -> exist

Gustavo's picture
Offline
Joined: 2006-09-11
Thank you so much,

Thank you so much, Bjwebb!

It's now fixed in the repository.

I'm working on the fifth draft because I introduced two important sections that were missing in the fourth one. More on this soon.

Cheers!

Gustavo's picture
Offline
Joined: 2006-09-11
Fifth working draft

Hello.

I thought I was not missing something, but I was wrong. Here's the fifth working draft: http://test.getgnulinux.org/temp/collaboration_guidelines/draft5/

Major changes:
+ Fixed many errata.
+ Added Locking and unlocking a file in a repository
+ Added why Translators should not use WYSIWYG editors.
+ Added Translating XML-based files.
+ Added what translators should never modify.

Complete changelog.

I think I was very demanding in several parts (again), but I'm not sure, what do you think? Please don't hesitate to tell me.

What do you think about the guidelines? Did I miss something? Should I removed something? Should I modify something? What about the HOWTOs?

By the way, doesn't "Collaborator Guide" sound better? Do you have a better title?

Once these guidelines are approved, we can start looking for more contributors, like more translators, ambassadors and people with access to the FSL repo.

Cheers!

Gustavo's picture
Offline
Joined: 2006-09-11
I've been thinking that it

I've been thinking that it makes no sense to include the section entitle "What anyone can do to help us out" in the Collaboration Guidelines. This guide is aimed at internal collaborators, not external ones.

That section's contents may easily be merged into http://planet.getgnulinux.org/help (actually, that section only extends this webpage).

What do you think about removing that section from the Collaborator Guidelines?

Gustavo's picture
Offline
Joined: 2006-09-11
Don't fear me

Don't fear me. I don't eat people. Smiling

If you think the guidelines are useless or dislike the overall work, please don't hesitate to say so.

Cheers!

ariadacapo's picture
Offline
Joined: 2006-07-13
I'll take your word for not

I'll take your word for not eating us and step in ;-) Sorry for being late.

I have gone through everything I think and here are my remarks:

  • Great work, and the part on SVN is especially great (screenshots and all). I really don't think it is a waste of time at all.
  • The main problem is the tone generally - often it's quite severe and authoritative, when in fact collaborators are doing us a favor, not the opposite ;-) There are places where I'll occasionally correct, but most of the time it's not highly important. It can be done as the guidelines evolve.

Now as for the smaller things, I think the "guidelines" title sounds better (less authoritative) - and personally I like the way the "helping us" section is built. The content is very nicely structured so readers can read quickly through anything, anyway.

How do you edit these files? I use Conglomerate, which is pretty unstable and I'm quite lost (can't even export these files to PDF). In fact I have made almost no progress on the GGL transition to XML - I'm stuck.

Gustavo's picture
Offline
Joined: 2006-09-11
Hi, Olivier. Please modify

Hi, Olivier.

Please modify the guidelines to make them sound friendly or anything else you want to add/remove/change. I thought that too when I was rereading that document, but I was not sure if some things need not be mandatory. This is mainly why I wanted to get some feedback.

On the other hand, do you think the svn how-to is absolutely beginner friendly? I mean, did I explained everything from scratch without supposing the reader had previous skills on something similar? If you were new to svn, that guide would be enough to get you started?

Cheers!

Gustavo's picture
Offline
Joined: 2006-09-11
Sixth working draft

Here I go, once again. Smiling

Sixth working draft.

Major changes:
+ Now the guidelines are friendly (from my viewpoint).
+ Removed what anyone can do to help us out. That fits in the "Help us" section of our planet.

Exact changes (from Rev. 32 to 36).

Unless someone disagrees, I consider this can be the final document (at last!).

Cheers!

ariadacapo's picture
Offline
Joined: 2006-07-13
Great, Gustavo... I hope I

Great, Gustavo...
I hope I can make the move to DocBook soon, so that collaboration can be made easier.

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.