Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
knowledge base: how-to documents via commandline?
View unanswered posts
View posts from last 24 hours

Goto page Previous  1, 2, 3  
Reply to topic    Gentoo Forums Forum Index Gentoo Chat
View previous topic :: View next topic  
Author Message
far
Guru
Guru


Joined: 10 Mar 2003
Posts: 394
Location: Stockholm, Sweden

PostPosted: Sun Nov 02, 2003 4:24 pm    Post subject: Reply with quote

Isn't there already a program that does this? I am thinking of Gnu Info. You wouldn't have to write the docs in texinfo format. You could write them in DocBook XML. There are existing filter that convert DocBook to texinfo, html, man pages, et cetera.
_________________
The Porthole Portage Frontend
Back to top
View user's profile Send private message
shash
Apprentice
Apprentice


Joined: 18 Apr 2003
Posts: 220
Location: India

PostPosted: Mon Nov 10, 2003 4:50 pm    Post subject: Reply with quote

I'd propose a set of test issues for this thing:


  • Can it adequately work both offline and on the web?
  • Does it have a user-friendly search engine? (Think Google).
  • Is it portable (both text and gui allowed, etc.)
  • Does it have internationalization support?
  • Is its default (you'd be suprised how many people stick to defaults) user-friendly?
  • Is it non-patronizing (M$ help, for example, is very patronizing)?
  • Is it able to give the right info to the right people? (a newbie, recoganized by his choices, would get the GUI tools, with a link to the config files, and a guy with more experience would get the config files document, and a link to the GUI).
  • Is it extensible?
  • Can it be appended to by all those who can do so? (prob. a system like the ebuilds)


This list, of course, is not complete, but should help in laying down a roadmap. :)

Of course, this means that I'm volunteering! :D ;)
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Gentoo Chat All times are GMT
Goto page Previous  1, 2, 3
Page 3 of 3

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum