FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.


» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > CentOS > CentOS Docs

 
 
LinkBack Thread Tools
 
Old 04-09-2011, 07:53 PM
Charles Polisher
 
Default Edit permission request + wiki tagging proposal

Please make me a wiki editor. I want to create my personal home page.

I'd like some feedback on an idea. I apologize for my verbosity.
Cut it to shreds. Thanks in advance!


TL;DR:

Gradually tag the CentOS wiki with <div>'s indicating status
with respect to content migration to website2.

Assumptions:

- Large amounts of existing wiki text will eventually migrate
to website2.

- Much existing content needs revision before it migrates.

- More resources (contributors) would help speed the process.

Problem statement:

While http://wiki.centos.org/WebsiteVer2 focuses on structure
and function of a new website, there is an editorial dimension.
It will be a lot of work to edit & migrate content to website2.
To speed up this process, it would be good to lower the barriers
to entry for people wishing to contribute, and to increase
opportunities for division of labor.

One such barrier to entry: It's hard for new contributors to
identify what stage of readiness text is in with respect to
migration to website2. The onus is on each editor to decipher
anew the status of any piece of text with respect to the new
website. Has it already been moved? Does it need further
discussion? Are there known issues with the accuracy of the
text? Is there an ongoing discussion of this text? (The problem
gets harder for longer pages that need to be migrated piecemeal
to website2.) It will be hard to jump in and start contributing
to content migration.

Proposed solution:

Tag wiki text inline using <div>'s to indicate its status for
inclusion in website2, marked with the following proposed classes.
Once a critical mass of text has been tagged, it will be easier
for web designers to migrate text to website2.

Proposed <div> classes:

<div class="ready">

Meaning: This text has been reviewed, is not controversial,
and SHOULD be moved as-is to website2.

Example:

<div class="ready JohnDoe">
Keep in mind that the home page itself is usually public,
everybody can read and also write it (and this is a good
thing, see it as a means of communication with you).
But you can also create protected sub-pages of it, so
restricting access to some of your pages is no problem.
</div>

When JohnDoe tags the text as "ready", the subsequent task of
finding an appropriate location and format for it on website2
can now be split out. This is good because choosing the new
placement in website2 may require different skills, different
permissions, a new category, new structure, or could entail
additional planning, coordination or discussion.

<div class="drop">

Meaning: This text SHOULDN'T be moved to website2, and shouldn't
be fixed to make it move-able.

Helper classes that SHOULD be included with this class:
{ wrong | licensed | confusing | redundant }

Examples:

<div class="drop wrong JohnDoe">
New CentOS users are encouraged to start by
re-compiling the Linux kernel from source.
</div>

<div class="drop licensed">
Red Hat Linux clustering...
</div>

<div class="drop confusing">
1. Before attempting the preceeding steps
2. go back and try procedure (b)
4. but you might also try (a), or even (c)
</dev>

<div class="moved">

Meaning: This text HAS BEEN moved to website2, (or some equivalent
textual or functional element has been created in website2 that
makes this text unnecessary).

Example:

<div class="moved BettySmith">
... text that has been migrated to website2 ...
</div>

<div class="mustfix">

Meaning: This text MUST be moved to website2, because it is essential
information that is still relevant, but MUST be edited first.
Helper classes that SHOULD be included with this class:
{ accuracy | spelling | link | grammar | rewrite | update }

Example:

<div class="mustfix spelling brokenlink JaneRoe">
CetnOS developrs are a hardy bunch. See some
of there writing at htpp://wyki.centos.org/
</div>

<div class="<UserName1> <UserName2> ...>"

Meaning: Who says? These helper meta-classes would afford a simple
voting-ish/review functionality.

Example:

<div class="ready MaryRoe JohnDoe">
Paragraph that both Mary and John think is ready to move.
Someone who is mostly interested in putting reviewed
text into the correct spot on website2 can now do so without
becoming a subject matter expert on the text's content.
</div>

<div class="discuss">

Meaning: There is ongoing discussion about this text on centos-docs
mailing list.

Example:

<div class="mustfix discuss">
... Release Notes for the CentOS LiveCD ...
</div>

Parting thought:

A custom style-sheet for wiki editors could be used to make
targeted categories of text visually stand out, eg: "moved" text
could be rendered in light gray, "mustfix" text could be
rendered in dark red, etc.

--
Charles Polisher


_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
http://lists.centos.org/mailman/listinfo/centos-docs
 
Old 04-10-2011, 10:20 PM
Ralph Angenendt
 
Default Edit permission request + wiki tagging proposal

Am 09.04.11 21:53, schrieb Charles Polisher:
> Please make me a wiki editor. I want to create my personal home page.

Is CharlesPolisher your wiki account?

> Assumptions:
>
> - Large amounts of existing wiki text will eventually migrate
> to website2.

Nope. "Website2" will have much less content than the current webpage
has. http://wiki.centos.org/JimWoods has some starting points (also into
the mailing lists.

Which means that most of the rest of your mail is based on a wrong
assumption, sorry.

Regards,

Ralph
_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
http://lists.centos.org/mailman/listinfo/centos-docs
 
Old 04-11-2011, 03:39 AM
Charles Polisher
 
Default Edit permission request + wiki tagging proposal

Ralph Angenendt wrote:
> schrieb Charles Polisher:
> > Please make me a wiki editor. I want to create my personal home page.
>
> Is CharlesPolisher your wiki account?

Yes it is, sorry for the omission.

> > Assumptions:
> >
> > - Large amounts of existing wiki text will eventually migrate
> > to website2.
>
> Nope. "Website2" will have much less content than the current webpage
> has. http://wiki.centos.org/JimWoods has some starting points (also into
> the mailing lists.
>
> Which means that most of the rest of your mail is based on a wrong
> assumption, sorry.

Thanks for the gentle response. I think I get it now.
What I mistook for a wholesale remake of
http://wiki.centos.org/
is a redo of http://www.centos.org/ ?

Perhaps something in my idea could be salvaged in some future
effort to enhamce the wiki's content.
--
Charles Polisher

_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
http://lists.centos.org/mailman/listinfo/centos-docs
 
Old 04-11-2011, 11:38 AM
Phil Schaffner
 
Default Edit permission request + wiki tagging proposal

Charles Polisher wrote on 04/10/2011 11:39 PM:
> Perhaps something in my idea could be salvaged in some future
> effort to enhamce the wiki's content.

The Wiki is in need of a lot of love, and need not wait on Website 2.0,
so please jump in with ideas and/or actions to improve it.

Phil
_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
http://lists.centos.org/mailman/listinfo/centos-docs
 
Old 04-11-2011, 10:19 PM
Ralph Angenendt
 
Default Edit permission request + wiki tagging proposal

Am 11.04.11 05:39, schrieb Charles Polisher:
> Ralph Angenendt wrote:
>> schrieb Charles Polisher:
>>> Please make me a wiki editor. I want to create my personal home page.
>>
>> Is CharlesPolisher your wiki account?
>
> Yes it is, sorry for the omission.

http://wiki.centos.org/CharlesPolisher is "yours" now.

> Thanks for the gentle response. I think I get it now.
> What I mistook for a wholesale remake of
> http://wiki.centos.org/
> is a redo of http://www.centos.org/ ?

Yes.

> Perhaps something in my idea could be salvaged in some future
> effort to enhamce the wiki's content.

Oh, what Phil said There's always something to do on the Wiki.

Regards,

Ralph
_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
http://lists.centos.org/mailman/listinfo/centos-docs
 

Thread Tools




All times are GMT. The time now is 12:48 PM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright 2007 - 2008, www.linux-archive.org