RFC: Some changes to htdocs/Documentation/index.html

Hi,

Please review and comment on:

	http://markweine
m.de/docs_index.html


Changes:

	* the sections get descriptive sentences
	* clearer separation between external resources and
NetBSD's own docu
	* additional links under "News, informations and
suppport" 
	  (#NetBSD Community Blog, Articles about NetBSD and Live
Chats)


Please help to improve. 


Thanks & Greetings, Mark  

-- 
Mark Weinem
Jabber: weinemjabber.cz
PGP-Key available

On Wed, 2 May 2007, Mark Weinem wrote:
> 	http://markweine
m.de/docs_index.html
>
>
> Changes:
>
> 	* the sections get descriptive sentences
> 	* clearer separation between external resources and
NetBSD's own docu

Those sound good

> 	* additional links under "News, informations and
suppport"
> 	  (#NetBSD Community Blog, Articles about NetBSD and
Live Chats)

I'd stick to adding (primary) netbsd documentation to 
htdocs/Documentation, and keep the list of meta-information
in the 
External Resources section away completely.


  - Hubert

Hi Hubert,

> I'd stick to adding (primary) netbsd documentation to
> htdocs/Documentation, and keep the list of
meta-information in the
> External Resources section away completely.

Do you mean to move "External Resources" to a
separate page or to move 
only the resources that are not docs (wikis, blogs, forums,
chats, 
etc...)?


-- 
Mark Weinem
Jabber: weinemjabber.cz
PGP-Key available

On Wed, 2 May 2007, Mark Weinem wrote:
>> I'd stick to adding (primary) netbsd documentation
to
>> htdocs/Documentation, and keep the list of
meta-information in the
>> External Resources section away completely.
>
> Do you mean to move "External Resources" to a
separate page or to move
> only the resources that are not docs (wikis, blogs,
forums, chats,
> etc...)?

I'd rather remove those wikis, blogs etc. completely from
that page, as 
it's not (directly) netbsd documentation. I'd rather move
them to the "See 
also" section on htdocs/Changes/index.xml


  - Hubert

Hubert Feyrer

> I'd rather remove those wikis, blogs etc. completely
from that page, as
> it's not (directly) netbsd documentation.

I fully agree. What about the "Online Documentation for
other Unix 
Systems" section?

But i don't think that wikis and IRC fit well under 
htdocs/Changes/index.xml

There is already htdocs/gallery/resources.xml ("Other
NetBSD Resources") 
but it's IMHO to hidden.


-- 
Mark Weinem
Jabber: weinemjabber.cz
PGP-Key available

On Wed, 2 May 2007, Mark Weinem wrote:
> I fully agree. What about the "Online
Documentation for other Unix
> Systems" section?
>
> But i don't think that wikis and IRC fit well under
> htdocs/Changes/index.xml
>
> There is already htdocs/gallery/resources.xml
("Other NetBSD Resources")
> but it's IMHO to hidden.

No idea...
maybe have your "external resources" section, and
make it so that it 
collects all those links in one file, similar to the
"Miscellaneous 
common NetBSD questions" section?

I'm not sure if that's better or worse than what we have
now.
(Do we have an overview over all this stuff? I don't! 


  - Hubert

On Wed, 2 May 2007 00:39:35 +0200
Mark Weinem <mark.weinemalumni.uni-duisburg-essen.de> wrote:

> Please review and comment on:
> 	http://markweine
m.de/docs_index.html
> 	* additional links under "News, informations and
suppport" 
> Please help to improve. 

"Information" has no plural in English. In Polish
does. 
Regards,
-- 
Przemysław Pawełczyk <pp_o2o2.pl>

Am Wednesday 02 May 2007 schrieb Przemysław Pawełczyk:
> On Wed, 2 May 2007 00:39:35 +0200
>
> Mark Weinem <mark.weinemalumni.uni-duisburg-essen.de> wrote:
> > Please review and comment on:
> > 	http://markweine
m.de/docs_index.html
> > 	* additional links under "News, informations
and suppport"
> > Please help to improve.
>
> "Information" has no plural in English. In
Polish does. 
> Regards,

Thanks for the hint. Corrections and improvements of my bad
English are 
always welcome.


kind regards, Mark

-- 
Mark Weinem
Jabber: weinemjabber.cz
PGP-Key available