Documentation:Developers Notes - Revision history

Jholsenback: unneeded content

2010-10-22T20:00:28Z

unneeded content

2010-03-30T12:39:32Z

wording

2010-03-30T12:37:39Z

wording corrections

2010-03-30T12:36:33Z

spelling and wording changes

2010-03-30T12:34:44Z

Introduction

2010-02-25T15:30:52Z

added link to a more detailed to do list

2009-06-23T15:10:12Z

external link handling change after recent update

2009-05-30T23:17:08Z

Must Hide

2009-05-30T23:16:22Z

Must Hide

2009-05-19T16:09:58Z

style edit

@@ Line 45: / Line 45: @@
 ====Left Justified====
 There were a number of html tags that just didn't work as you'd expect, until the became the first character of a new line. There are also certain wiki tags that have the same requirement, so it was necessary to get rid of leading tabs and spaces in some places.
 ==Take Me Back==

@@ Line 23: / Line 23: @@
 These tags are for indexing and searching purposes. They are ''critical'' to down stream processes.
-These have no end user viewable information so they are commented out.
+Since they have no end user viewable information so they are commented out.
 <pre><!--<sectiondesc desc="Unix specific">---></pre>
 <pre><!--<indexentry "average, tutorial">---></pre>

@@ Line 23: / Line 23: @@
 These tags are for indexing and searching purposes. They are ''critical'' to down stream processes.
-These is have no end user viewable information so they are commented out.
+These have no end user viewable information so they are commented out.
 <pre><!--<sectiondesc desc="Unix specific">---></pre>
 <pre><!--<indexentry "average, tutorial">---></pre>

@@ Line 16: / Line 16: @@
 ===The Translation===
-The repository documents were produced by a perl script. It converted the html files into MediaWiki markup language preserving ''POV-centric'' tags that are critical to the final creation of distribution documentation sets, produced [[Documentation:Contents#The Chapters|The Chapters]] table of contents files, and resolved section to section hyper-links that tie the documentation togeather. MediaWiki markup understands many standard html tags, so by in large most things get passed on ''as-is'', however there are some exceptions that are covered in the tag summary below.
+The repository documents were produced by a perl script. It converted the html files into MediaWiki markup language preserving ''POV-centric'' tags that are critical to the final creation of distribution documentation sets, produced [[Documentation:Contents#The Chapters|The Chapters]] table of contents files, and resolved section to section links that tie the documentation together. MediaWiki markup understands many standard html tags, so by in large most things get passed on ''as-is'', however there are some exceptions that are covered in the tag summary below.
 ===Tag Summary===

@@ Line 13: / Line 13: @@
 ==The Content==
 ===Introduction===
-If you've already had a look at the [[Documentation:Contents|contents]] then you've noticed that it only vaguely looks like the distribution documentation. Let me explain. In order to facilitate  the concurrent activities of converting this content to version 3.7 and the developement of the Wiki extension that will produce the final documentation sets, it was decided go with a pretty basic content and navigation scheme for the first phase of this project. Getting the user community involved as soon as possible is essential to the timely completion of this project.
+If you've already had a look at the [[Documentation:Contents|contents]] then you've noticed that it only vaguely looks like the distribution documentation. Let me explain. In order to facilitate  the concurrent activities of converting this content to version 3.7 and the developement of the PHP script(s) that will produce the final documentation sets, it was decided go with a pretty basic content and navigation scheme for the first phase of this project. Getting the user community involved as soon as possible is essential to the timely completion of this project.
 ===The Translation===

@@ Line 62: / Line 62: @@
 Awkwardly worded passages and spelling errors.
-====Assigning Tasks====
+====More Details====
-This [http://bugs.povray.org/task/3?project=2 project] will make use of the POV-Ray bug track system. When contributors have been recruited and spoken up for one of the five [[Documentation:Contents#The Chapters|chapters]] the project coordinator will enter a new task and assign ownership so redundant efforts can be avoided and progress can easily be tracked.
+Have a look at this more detailed [[Documentation:ToDo|to do]] list.
 ====A Change Example====

@@ Line 35: / Line 35: @@
 ====Must Hide====
 Some tags for various reasons were hidden from end user view with the comments notation. See the examples given above.
-<p class="BeAware">
+<p class="Warning">
 ANYTHING enclosed in the comments notation should not be changed in ANY way.
 </p>

@@ Line 6: / Line 6: @@
 <br>
 ==Introduction==
-On this page you will find information about the repository content, were it came from, and why it dosen't appear '''exactly''' like the documentation that is currently being distributed with the POV-Ray&trade; application, as well as information for contributors that wish to get involved with this project.
+On this page you will find information about the repository content, were it came from, and why it dosen't appear '''exactly''' like the documentation that is currently being distributed with the POV-Ray application, as well as information for contributors that wish to get involved with this project.
 ==The Source==
-The images and html files used to generate this repository came from the POV-Ray&trade; revision control depot. They are representative of the current state (version 3.5/3.6) documentation that is currently being distributed with the POV-Ray&trade; application.
+The images and html files used to generate this repository came from the POV-Ray revision control depot. They are representative of the current state (version 3.5/3.6) documentation that is currently being distributed with the POV-Ray application.
 ==The Content==