RPTools.net

Discussion and Support

Skip to content

It is currently Mon Nov 20, 2017 2:45 am 






Reply to topic  [ 93 posts ]  Go to page Previous  1, 2, 3, 4, 5, 6, 7  Next

Previous topic | Next topic 

  Print view

Author Message
User avatar  Offline
Deity
 
Joined: Fri Mar 20, 2009 4:40 am
Posts: 9419
Location: Netherlands
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Feb 23, 2011 6:09 am 
CoveredInFish wrote:
Its probably best to "quick repair" such markup. So text should be text and headings should be headings, that way the document is better to read&edit and its easier for me to tex it up later. But we souldnt spend much affort/time into making it look nice.


well as I mentioned, I did that, but for some parts (big parts actually) but it does not fall in the 'quick' category, unless you're satisfied that ALL text make up is gone.

_________________
GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC

My stuff
Excel Tools: Table and Light editors
MT Tools: Bag of Tricks: Tools for Maptool, Dungeon Builder I, Dungeon Builder II,onMouseOverEvent and
DPI.
Frameworks: Dark Heresy, Rogue Trader, Deathwatch, Black Crusade, Only War, SET Card Game, RoboRally
Wiki: Debugging Tutorial, Speed Up Your Macros, Working With Two CODE Levels, Shortcut Keys, Avoiding Stack Overflow, READ THIS


Top
 Profile  
 
User avatar  Offline
Demigod
 
Joined: Mon Jun 29, 2009 9:37 am
Posts: 3108
Location: Germany
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Feb 23, 2011 8:03 am 
Nah ... better some structure than nothing. I think chapter/section/subsection should be set as actual headings, for the rest it is probably enough if i can recognize it manually.

_________________
HELP: GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC.

most complete list of my maptool stuff


Top
 Profile  
 
User avatar  Offline
Deity
 
Joined: Tue Sep 11, 2007 6:31 pm
Posts: 5412
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Feb 23, 2011 9:40 am 
I would also highly suggest much in the way of optimization comments or "callouts". One big example is people who dump 500 Dundjinni images(default to 200px per inch) into maptool and wonder why their maps take forever for the clients to receive and load. Ditto with the drawing tools. Ditto with the VBL tools, re: circle tool vs X's for columns, trees, etc...

I say "callouts" as they generally bring quick attention to something by being visually prominent.

_________________
I save all my Campaign Files to DropBox. Not only can I access a campaign file from pretty much any OS that will run Maptool(Win,OSX, linux), but each file is versioned, so if something goes crazy wild, I can always roll back to a previous version of the same file.

Get your Dropbox 2GB via my referral link, and as a bonus, I get an extra 250 MB of space. Even if you don't don't use my link, I still enthusiastically recommend Dropbox..


Top
 Profile  
 
User avatar  Offline
Demigod
 
Joined: Mon Jun 29, 2009 9:37 am
Posts: 3108
Location: Germany
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Feb 23, 2011 10:29 am 
Good point. There'll be need for that.

I'll have to experiment a bit in LaTeX but I'm sure there'll be something eye-catching possible.It looks like TikZ allows some awful graphic integration (example)

_________________
HELP: GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC.

most complete list of my maptool stuff


Top
 Profile  
 
 Offline
Giant
 
Joined: Tue Nov 18, 2008 10:16 am
Posts: 136
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Fri Feb 25, 2011 11:11 am 
jfrazierjr wrote:
I would also highly suggest much in the way of optimization comments or "callouts". One big example is people who dump 500 Dundjinni images(default to 200px per inch) into maptool and wonder why their maps take forever for the clients to receive and load. Ditto with the drawing tools. Ditto with the VBL tools, re: circle tool vs X's for columns, trees, etc...

I say "callouts" as they generally bring quick attention to something by being visually prominent.


I was thinking the same way. I'd say Box or Sidebar instead of Callout but I think we mean the same thing. Headings could be "Optimization: Smart VBL" or "Optimization: Just Enough Image." That way the reader would get used to seeing, remembering and applying the contents of those boxes.


Top
 Profile  
 
 Offline
Cave Troll
 
Joined: Thu Feb 04, 2010 12:17 am
Posts: 92
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 12:50 am 
Hi, back after a long time away. Curious to see how the manual is coming along - I noticed last post here was late Feb 2011. Did the project die?

_________________
Al B. USAF RET.
*Chief Organizer and Bottle Washer - 'User Creations' Forum*

MT Framework Directory **LISTING** (UPDT 2012-02-10)


Top
 Profile  
 
User avatar  Offline
Deity
 
Joined: Fri Mar 20, 2009 4:40 am
Posts: 9419
Location: Netherlands
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 12:54 am 
Gamerdude wrote:
Hi, back after a long time away. Curious to see how the manual is coming along - I noticed last post here was late Feb 2011. Did the project die?


The thought lingers on in my signature...

_________________
GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC

My stuff
Excel Tools: Table and Light editors
MT Tools: Bag of Tricks: Tools for Maptool, Dungeon Builder I, Dungeon Builder II,onMouseOverEvent and
DPI.
Frameworks: Dark Heresy, Rogue Trader, Deathwatch, Black Crusade, Only War, SET Card Game, RoboRally
Wiki: Debugging Tutorial, Speed Up Your Macros, Working With Two CODE Levels, Shortcut Keys, Avoiding Stack Overflow, READ THIS


Top
 Profile  
 
User avatar  Offline
Demigod
 
Joined: Mon Jun 29, 2009 9:37 am
Posts: 3108
Location: Germany
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 1:32 am 
"Die" is such a hard word. Its more like ... a long sleep.

If you like to bring some fresh energy into this it might wake up :D

_________________
HELP: GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC.

most complete list of my maptool stuff


Top
 Profile  
 
User avatar  Offline
Deity
 
Joined: Fri Mar 20, 2009 4:40 am
Posts: 9419
Location: Netherlands
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 1:45 am 
CoveredInFish wrote:
"Die" is such a hard word. Its more like ... a long sleep.

If you like to bring some fresh energy into this it might wake up :D


I think hybernation is a suitable description. Either that or its in cryo state 8)

_________________
GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC

My stuff
Excel Tools: Table and Light editors
MT Tools: Bag of Tricks: Tools for Maptool, Dungeon Builder I, Dungeon Builder II,onMouseOverEvent and
DPI.
Frameworks: Dark Heresy, Rogue Trader, Deathwatch, Black Crusade, Only War, SET Card Game, RoboRally
Wiki: Debugging Tutorial, Speed Up Your Macros, Working With Two CODE Levels, Shortcut Keys, Avoiding Stack Overflow, READ THIS


Top
 Profile  
 
User avatar  Offline
Great Wyrm
 
Joined: Tue Aug 23, 2011 10:41 am
Posts: 1134
Location: Cornwall, UK
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 12:22 pm 
Considering that the MapTool macro language will be changed for 1.4, I think people are less willing to help add to the documentation. Only a few times have I needed an example of code and there not being one there. It took me a long time to understand CIF's forms tutorial, but I got there with some assistance from the forum.

I'd more than willingly contribute to the documentation (I added a line on the google doc a few weeks ago that was missing), however I feel my time is better spent ploughing through my framework for a release.

_________________
How to get around the two code nest limit in MapTool (and MOTE)


Top
 Profile  
 
User avatar  Offline
Site Admin
 
Joined: Mon Jun 12, 2006 12:20 pm
Posts: 12103
Location: Tampa, FL
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 2:42 pm 
This thread was not for macro stuff. It was for MapTool itself. Think of it as a written version of the excellent screencast tutorials that brad put together...


Top
 Profile  
 
User avatar  Offline
Demigod
 
Joined: Mon Jun 29, 2009 9:37 am
Posts: 3108
Location: Germany
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Wed Oct 12, 2011 3:12 pm 
What we did did until now: we collected text and united it into a single document. This is mostly stuff from the wiki. Macro - indeed - is not the focus for this.

It is NOT seemless. What we didnt do until now is: read it, fix the gaps and seems, make it feel like *one text*.

If that is done I'd format the stuff and latex it.

_________________
HELP: GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC.

most complete list of my maptool stuff


Top
 Profile  
 
 Offline
Giant
 
Joined: Tue Nov 18, 2008 10:16 am
Posts: 136
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Thu Oct 13, 2011 6:41 am 
I did write some new material in the drawing tools section. But soon got sidetracked by real life. I hope to do more one day, but my work schedule for real life means you can't rely on me. Will this material get added to the Wiki? I question the need for a PDF document, except as a support for the wiki.


Top
 Profile  
 
User avatar  Offline
Demigod
 
Joined: Mon Jun 29, 2009 9:37 am
Posts: 3108
Location: Germany
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Thu Oct 13, 2011 7:43 am 
If someone adds it ... it'll be added. If you need a user account for the wiki I think you'd need to ask craig. It was open once but the anti-spam-measures were broken ...

Sadly my free time is pretty precious as well, or i'd search for new stuff and add it myself.

_________________
HELP: GETTING STARTED WITH MAPTOOLS - TUTORIALS, DOCS, VIDEOS, TOOLS, ETC.

most complete list of my maptool stuff


Top
 Profile  
 
User avatar  Offline
Kobold
 
Joined: Tue Feb 21, 2012 8:43 am
Posts: 13
Location: Ithaca, NY
 Post subject: Re: Official(?) MT 1.3 Documentation Project
PostPosted: Fri Feb 24, 2012 8:55 am 
Thought the documentation project seems a bit stalled, I thought I'd pitch in and do some work on it. Besides fixing a few typos, I've been adding content to "2. MapTool Windows & Objects". I've added a high level description of the MT pane layout using screen captures. Without going into a lot of detail, I describe each pane using screen captures.

Later, we can add sections to the document that drill down into these panes as appropriate.

I have the PDF snapshot of Azhrei's networking paper and propose that we add it and maybe edited it down a bit.

Personally, I think the idea of having a downloadable manual would be an excellent addition to the MT documentation set. The wiki is useful, especially the tutorials. I propose that we make the manual be more expository and leave the tutorials for the wiki - videos work so much better on a computer screen than on paper. References to the tutorials can be included in the manual, but the links need to be stable and the tutorials need to be up-to-date.

Comments are welcome.

- Mark Norton


Top
 Profile  
 
Display posts from previous:  Sort by  
Reply to topic  [ 93 posts ]  Go to page Previous  1, 2, 3, 4, 5, 6, 7  Next

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 post attachments in this forum

Search for:

Who is online

In total there is 1 user online :: 0 registered, 0 hidden and 1 guest (based on users active over the past 5 minutes)
Most users ever online was 243 on Sun Nov 04, 2012 6:14 am

Users browsing this forum: No registered users and 1 guest





Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group

Style based on Andreas08 by Andreas Viklund

Style by Elizabeth Shulman