[Bf-docboard] Current state of wiki updating.

[Jared Reisweber]

I kind of agree with Fade. I would be interested in continuing to help add
wiki pages again. I had made a bunch of wiki structure changes a while
back, that should have been reviewed prior, but things like adding content
to pages, or moving content to appropriate pages could be well ahead of
where it is now if the review process was eased up a bit. It's troubling to
learn that, after such a big deal was made over a new reviewing process,
not much progress has been made. I have a hard time believing the manual
would get that out of hand by opening up page editing, as long as there is
consistency in formatting guidelines that are followed. Are there really
that many people actively working on the manual?

On the topic of manual structure, there are several areas of redundancy and
inconsistency in the manual index I think could be improved on. For example
these 7 pages:

   - Graph Editor
   - F-Curves
   - -F-Curves Types
   - -F-Curves Graph Editor Interface
   - -Editing
   - --F-Curves
   - --Keyframes

could be easily fit into about 3 pages:

   - Graph editor
   - F-curves
   - Editing f-curves

There is inconsistency in the grouping of Blender functions into manual
pages. I would argue that some pages might be too specific. Like, do we
really need 6 pages on selecting mesh components? And only 1 page on
animating Armatures? Resolving things like these would reduce the empty
page count(~137), and make it less confusing, and easier to add content in
the appropriate places, in my opinion. (e.g. the mesh editing and animation
pages)

Anyways, that's my thoughts.

On Sat, Sep 1, 2012 at 2:17 PM, Fade <fade_docboard_blender at ymail.com>wrote:

>  I don't know about Ton, but Brecht usually documents whatever he's
> working on as he codes it so I'd imagine he's aware of the general lack of
> activity.
>
> -Fade
>
>
> On 09/01/12 16:05, Robert wrote:
>
> Has Ton, Brecht, or one of the main developers seen this problem yet?
> -Robert
> On 9/1/2012 10:19 AM, fade_docboard_blender at ymail.com wrote:
>
> I know what you mean, I've got nearly 20 pages linked in the task list (
> http://wiki.blender.org/index.php/Meta:Wiki_Tasks/Review_2.6_Manual) and
> again on my user page that haven't been reviewed. Some of these have been
> sitting there since the start of February. Waiting 7 months for a review
> has all but killed my interest in contributing. I'm also going to be *that
> guy* and say that I called it (
> http://lists.blender.org/pipermail/bf-docboard/2012-February/003861.html).
>
> I know that there was a lot of effort put into setting up this review
> process but it hasn't worked and doesn't look like it's going to. There
> simply aren't enough people with enough time to make this system work
> properly.
>
> Keeping the task list is useful, but I'm inclined to think that it's time
> to ditch the whole review thing. At this point, it's just holding up
> improvements to the manual. I know that it was put in place for quality
> control, but it's had the opposite effect since none of the contributions
> are making it into the manual and we're still left with the incorrect and
> outdated pages.
>
> The review system is just placing obstacles in front of current and
> potential contributors and I'd rather run the risk of some lower quality
> pages so that it's easier for people to contribute.
>
> Cheers
> Fade
>
> On 08/28/12 01:20, Sascha wrote:
>
> I had posted updates for the strands, build modifier, particle mode, and
> bake pages over 4 months ago, but they still haven't been reviewed
> I've really lost all momentum on wiki editing after this much time waiting
> for a proof-read
>
>
> http://wiki.blender.org/index.php/User:Sascha_Uncia/Doc:2.6/Manual/Materials/Properties/Strands
>
> http://wiki.blender.org/index.php/User:Sascha_Uncia/Doc:2.6/Manual/Physics/Particles/Mode
>
>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20120902/3e4c5eaf/attachment.htm