Difference between revisions of "Talk:Manual"

From VsWiki
Jump to: navigation, search
m (Base Interface/ Computer Screens Discussion: moved comment)
(Base Interface/ Computer Screens Discussion)
 
(15 intermediate revisions by 5 users not shown)
Line 23: Line 23:
 
** http://vegastrike.sourceforge.net/gallery/wiki_manual
 
** http://vegastrike.sourceforge.net/gallery/wiki_manual
 
** I already put some needed sdcreenshots there, but they need to be scaled/finished/cut to be used in the manual.
 
** I already put some needed sdcreenshots there, but they need to be scaled/finished/cut to be used in the manual.
 +
*The thumbnail on the main page displays my version, but the large cover in the manual is from another. I don't have much intention of completing my version because of this talk about the new logo and such, but I've [http://eliot.bambi.net/ih/vegastrike/manualcover.zip put up] the zipped XCF file for people to gimp around with if they so choose. -[[User:Halleck|Halleck]] 21:25, 15 Mar 2005 (PST)
  
 
= Base Interface/ Computer Screens Discussion =
 
= Base Interface/ Computer Screens Discussion =
Line 34: Line 35:
 
*** http://vegastrike.sourceforge.net/phpwiki/index.php/VsManualUpgradesScreen
 
*** http://vegastrike.sourceforge.net/phpwiki/index.php/VsManualUpgradesScreen
 
*** etc...
 
*** etc...
* [[User:silverain|silverain]] 03:01, 15 Mar 2005 (PST) Since the Information Screen and Game Menu screen are common between several areas (Cargo Screen, Upgrades etc all access these two screens, would it be worthwhile extracting them and showing them as 'Common Menus' at the beginning of 'Interface'? I started to do this to the manual page, but its now gone.
+
* [[User:Silverain|Silverain]] 03:01, 15 Mar 2005 (PST) Since the Information Screen and Game Menu screen are common between several areas (Cargo Screen, Upgrades etc all access these two screens, would it be worthwhile extracting them and showing them as 'Common Menus' at the beginning of 'Interface'? I started to do this to the manual page, but its now gone.
  
 
** [[User:pontiac|pontiac]] 03:36, 15 Mar 2005 (PST) At first i imagined to have all the non-baseart (== Computer Screens) locations under the the "Base interface". And only the rest (bar/hangar/etc...)
 
** [[User:pontiac|pontiac]] 03:36, 15 Mar 2005 (PST) At first i imagined to have all the non-baseart (== Computer Screens) locations under the the "Base interface". And only the rest (bar/hangar/etc...)
Line 61: Line 62:
 
*** [[Manual:Computer:Ship dealer]]
 
*** [[Manual:Computer:Ship dealer]]
 
*** [[Manual:Computer:Game menu]]
 
*** [[Manual:Computer:Game menu]]
 +
* [[User:Silverain|Silverain]] 14:54 15 March 2005 (PST) Whereas, I had imagined it as information grouped together i.e. Location Cargo Bay, followed by Cargo Computer (all trading together), Location Shipyard with Computer Ship Dealer etc.  If we go your way, then I would suggest removing the Manual:Trading etc pages and going with the Location and Computer pages only.  It shouldn't be hard to split.
 +
** [[User:pontiac|pontiac]] 07:44, 16 Mar 2005 (PST) The main reason why i'm thinking of seperating computer screens from the locations is that '''the locations vary alot troughout the existing bases (sometimes there isn't even a cargo bay or a seperate weapons dealer)''' , but the computer is (nearly) always the same. But then again, your point is valid too, so your example would look like this? :
 +
*** [[Manual:Location:Concourse]]
 +
*** [[Manual:Location:Bar]]
 +
*** [[Manual:Location:Hanger]]
 +
*** [[Manual:Location:Cargo bay]]
 +
**** [[Manual:Computer:Cargo dealer]]
 +
*** [[Manual:Location:Shipyard]]
 +
**** [[Manual:Computer:Weapons dealer]]
 +
**** [[Manual:Computer:Ship dealer]]
 +
*** etc...
 +
* [[User:pontiac|pontiac]] 08:55, 16 Mar 2005 (PST) Ok, i think i have found a good middle way to go. What about using your structure (as you mentioned above and is pictured in the last example) in the manual mainpage, and also use the namespaces [Manual:Location:xxx] and [Manual:Computer:xxx] like in the examples. Then we have two seperate pages [Manual:Locations] and [Manual:Computer] that list the appropriate pages in them. That way we have both 'categories' at the same time.
 +
[[User:Silverain|Silverain]] 16:54, 16 Mar 2005 (PST) See an alternative layout of the Manual front page in the [[Sandbox]]
 +
* [[User:pontiac|Pontiac]] Looks good to me. Just two things: '''1.)''' The important one: What will happen to [[Manual:Trading]] and its content then? Do we leave it as is or incorporate the content into the cargo pages? '''2.)''' CAPITAL LETTERS ARE BAD i've learned ;) But that's just '''my''' opinion, and since i made this in the old wiki too i'm not ''fully'' against it. We can just leave it as in the mockup and sort that out '''if''' users complain ;)
 +
** [[User:pontiac|Pontiac]] ok, forget the first point. i've seen you moved the page already ;)
 +
** [[User:Silverain|Silverain]] 23:55, 17 Mar 2005 (PST) CAPS are bad?  I presume some netiquette thing?  I was looking for some way to really have the links stand out from surrounding descriptions - but no problem will change to LC.  I can then move it the changed mockup to the main page so the links are there.
 +
*** [[User:pontiac|Pontiac]] Netiquette doesn't really apply here (no dialog ;) ) but actally, i've read and adapted some of the Wikipedia style-guide. It more or sell says that you write a header exactly the same way as you would write a nomal sentence. (The only capital letters are the First one and the first ones of names). No biggie though, the content is more important anyway.
 +
 +
= Manual style discussion =
 +
* [[User:pontiac|Pontiac]] Maybe some points of our current and future discussions should be in the [[VsWiki:Manual_of_Style|Manual of Style]] as well. This includes several points:
 +
** Handling of images
 +
** Using of key-images (see [[Manual:Keyboard layout]])
 +
** Linking (including redundant links)
 +
** How to use the Manual NAVBAR
 +
** Categorisation / How to add category links
 +
 +
= Tutorial discussion =
 +
* [[User:Silverain|Silverain]] 14:58 15 March 2005 (PST) Concerning the tutorial, I was going to review my .pdf version and put it in.  Since its 5 tutes, should I use 5 pages (one each), or put them all on the one page?
 +
** [[User:pontiac|pontiac]] 07:44, 16 Mar 2005 (PST) In the wiki i think i would prefer them on one page '''if they are short''' (<= A4). For longer ones i think leaving them as 5 pages is perect (something like <nowiki>[[Manual:Tutorial:Page1]] or [[Manual:Tutorial:Chapter1]]</nowiki> maybe?)
 +
*** Then again: '''It's a turorial, so having 'steps/pages/chapters' is quite fine''' ;)
 +
**** [[User:Silverain|Silverain]] 16:13, 16 Mar 2005 (PST) Have uploaded the tutorials to the one page.  Have a look.  It seems to fit OK on the one page.  Except for the first one, they are all fairly short.
 +
***** [[User:pontiac|Pontiac]] Looks fine to me :)  But if you ''need'' to change it for the pdf version just go ahead.

Latest revision as of 16:48, 18 March 2005

TOC Discussion

  • Is it possible to put a picture next to the TOC? Maybe with a table? Pontiac 07:48, 27 Feb 2005 (PST)
    • OK, found a (more complicated, since it's an external image) way to do it Pontiac 08:28, 27 Feb 2005 (PST)
{|
|valign=top|__TOC__ 
|http://vegastrike.sourceforge.net/albums/wiki_manual/coverB.jpg
|}

Links

Various Cover Images

  • pontiac 05:59, 13 Mar 2005 (PST) Until the Upload to the wiki has been discussed you can use the Wiki-Manual section in the gallery:
  • The thumbnail on the main page displays my version, but the large cover in the manual is from another. I don't have much intention of completing my version because of this talk about the new logo and such, but I've put up the zipped XCF file for people to gimp around with if they so choose. -Halleck 21:25, 15 Mar 2005 (PST)

Base Interface/ Computer Screens Discussion

    • pontiac 03:36, 15 Mar 2005 (PST) At first i imagined to have all the non-baseart (== Computer Screens) locations under the the "Base interface". And only the rest (bar/hangar/etc...)
      • MOVED AND UPDATED-> See sample below

Silverain 16:54, 16 Mar 2005 (PST) See an alternative layout of the Manual front page in the Sandbox

  • Pontiac Looks good to me. Just two things: 1.) The important one: What will happen to Manual:Trading and its content then? Do we leave it as is or incorporate the content into the cargo pages? 2.) CAPITAL LETTERS ARE BAD i've learned ;) But that's just my opinion, and since i made this in the old wiki too i'm not fully against it. We can just leave it as in the mockup and sort that out if users complain ;)
    • Pontiac ok, forget the first point. i've seen you moved the page already ;)
    • Silverain 23:55, 17 Mar 2005 (PST) CAPS are bad? I presume some netiquette thing? I was looking for some way to really have the links stand out from surrounding descriptions - but no problem will change to LC. I can then move it the changed mockup to the main page so the links are there.
      • Pontiac Netiquette doesn't really apply here (no dialog ;) ) but actally, i've read and adapted some of the Wikipedia style-guide. It more or sell says that you write a header exactly the same way as you would write a nomal sentence. (The only capital letters are the First one and the first ones of names). No biggie though, the content is more important anyway.

Manual style discussion

  • Pontiac Maybe some points of our current and future discussions should be in the Manual of Style as well. This includes several points:
    • Handling of images
    • Using of key-images (see Manual:Keyboard layout)
    • Linking (including redundant links)
    • How to use the Manual NAVBAR
    • Categorisation / How to add category links

Tutorial discussion

  • Silverain 14:58 15 March 2005 (PST) Concerning the tutorial, I was going to review my .pdf version and put it in. Since its 5 tutes, should I use 5 pages (one each), or put them all on the one page?
    • pontiac 07:44, 16 Mar 2005 (PST) In the wiki i think i would prefer them on one page if they are short (<= A4). For longer ones i think leaving them as 5 pages is perect (something like [[Manual:Tutorial:Page1]] or [[Manual:Tutorial:Chapter1]] maybe?)
      • Then again: It's a turorial, so having 'steps/pages/chapters' is quite fine ;)
        • Silverain 16:13, 16 Mar 2005 (PST) Have uploaded the tutorials to the one page. Have a look. It seems to fit OK on the one page. Except for the first one, they are all fairly short.
          • Pontiac Looks fine to me :) But if you need to change it for the pdf version just go ahead.