NRAO Home  >  Green Bank  |  Wiki Topic:    GB > PTCS > FormalDocumentation (r1.1 vs. r1.14)
   Changes | Index | Search | Statistics | Go
 <<O>>  Difference Topic FormalDocumentation (r1.14 - 07 Oct 2008 - MartyBloss)
Added:
>
>


 <<O>>  Difference Topic FormalDocumentation (r1.13 - 27 Jul 2008 - ToddHunter)
Changed:
<
<

  • SystemNotes (SN) OBSOLETE -- DO NOT CREATE ANY MORE OF THESE PER RMP
>
>

  • SystemNotes (SN) __OBSOLETE -- DO NOT CREATE ANY MORE OF THESE
Changed:
<
<

>
>

Deleted:
<
<

Deleted:
<
<

Deleted:
<
<


 <<O>>  Difference Topic FormalDocumentation (r1.12 - 24 Apr 2007 - JohnFord)
Changed:
<
<

>
>

  • SystemNotes (SN) OBSOLETE -- DO NOT CREATE ANY MORE OF THESE PER RMP

 <<O>>  Difference Topic FormalDocumentation (r1.11 - 02 Apr 2007 - RichardPrestage)
Changed:
<
<

Substantive, non-ephemeral project documentation that should be archived. This includes documentation from the ConceptualDesignReview and in the future will include documentation from the In-Progress Reviews.

>
>

This includes documentation from the ConceptualDesignReview. Unfortunately, documentation for the InProgressReview ended up in the ProjectNotes series.

Changed:
<
<

>
>

Changed:
<
<

>
>


 <<O>>  Difference Topic FormalDocumentation (r1.10 - 09 Dec 2006 - RichardPrestage)
Deleted:
<
<

  • ProgramPlan? PTCS contributions to the GBT section of the Program Plan

  • VistingCommitteeReports? PTCS contributions to the GBT Visiting and Users Committee Reports

 <<O>>  Difference Topic FormalDocumentation (r1.9 - 03 Aug 2004 - RichardPrestage)
Added:
>
>

  • ProgramPlan? PTCS contributions to the GBT section of the Program Plan

 <<O>>  Difference Topic FormalDocumentation (r1.8 - 03 Mar 2004 - RichardPrestage)
Added:
>
>

  • VistingCommitteeReports? PTCS contributions to the GBT Visiting and Users Committee Reports

 <<O>>  Difference Topic FormalDocumentation (r1.7 - 30 Nov 2003 - RichardPrestage)
Changed:
<
<

  • External Project Review Meetings
>
>


 <<O>>  Difference Topic FormalDocumentation (r1.6 - 31 Oct 2003 - RichardPrestage)
Changed:
<
<

PTCS documentation falls into one of five different classes:

>
>

PTCS documentation (apart from these wiki pages) falls into a number of different categories:

Added:
>
>


 <<O>>  Difference Topic FormalDocumentation (r1.5 - 27 Sep 2003 - RichardPrestage)
Deleted:
<
<

Changed:
<
<

  • ProjectNotes (PN)
  • >
    >

    Deleted:
    <
    <

    Changed:
    <
    <

  • SystemNotes (SN)
  • >
    >

    Deleted:
    <
    <

    Changed:
    <
    <

  • QuarterlyReports
  • >
    >

    Deleted:
    <
    <

    Changed:
    <
    <

  • Project Artifacts (PA). This includes: Project Charters; design documents that encompass a portion of, but not the whole project (for example, software or electronics design documentation that may be used internal to those divisions).
  • Modification Requests (MR). These are lightweight (1-3 page) summaries of a task to be accomplished, the approach to completing that task, appropriate design summary or design constraints, and test details to ensure that what is delivered meets expectations. These are currently only used for the software division.
  • >
    >

    • InternalProgressMeetings These are the presentation slides (not minutes) from the internal project progress meetings, held approximately once every six weeks (unless an external project review usurps them).

     <<O>>  Difference Topic FormalDocumentation (r1.4 - 26 Sep 2003 - RichardPrestage)
    Changed:
    <
    <

    PTCS documentation falls into one of four different classes:

    >
    >

    PTCS documentation falls into one of five different classes:

    Added:
    >
    >

  • QuarterlyReports The standard reports which we submit as part of the larger NRAO Quarterly Report.

  •  <<O>>  Difference Topic FormalDocumentation (r1.3 - 20 Sep 2003 - RichardPrestage)
    Changed:
    <
    <

    that should be archived. This might include documentation from review sessions (CoDR, CDR, PDR).

    >
    >

    that should be archived. This includes documentation from the ConceptualDesignReview and in the future will include documentation from the In-Progress Reviews.


     <<O>>  Difference Topic FormalDocumentation (r1.2 - 07 Sep 2003 - RichardPrestage)
    Deleted:
    <
    <

    Deleted:
    <
    <


     <<O>>  Difference Topic FormalDocumentation (r1.1 - 05 Sep 2003 - RichardPrestage)
    Added:
    >
    >

    %META:TOPICINFO{author="RichardPrestage" date="1062805560" format="1.0" version="1.1"}% %META:TOPICPARENT{name="WebHome"}%

    PTCS Formal Documentation

    PTCS documentation falls into one of four different classes:

    • ProjectNotes (PN) This is the general documentation category, analogous to the GBT Memo Series. As well as more formal documentation, this category may be used to capture memos that serve as useful background, random thoughts that should be preserved, ideas that may be useful about upcoming tasks, and so forth. Any documentation that does not fall into the remaining three categories, but is still worthy of being archived, falls in this category.
    • SystemNotes (SN) Substantive, non-ephemeral project documentation that should be archived. This might include documentation from review sessions (CoDR, CDR, PDR).
    • Project Artifacts (PA). This includes: Project Charters; design documents that encompass a portion of, but not the whole project (for example, software or electronics design documentation that may be used internal to those divisions).
    • Modification Requests (MR). These are lightweight (1-3 page) summaries of a task to be accomplished, the approach to completing that task, appropriate design summary or design constraints, and test details to ensure that what is delivered meets expectations. These are currently only used for the software division.

    How to create a PTCS Project or System Note:

    Project or System Notes should be created in either MS WORD or LaTeX. In either case, the output should be converted to PDF format (using Acrobat Distiller or pdflatex) as the final format for distribution.

    To create a Project or System Note using MS WORD

    • Take a copy of the appropriate ".dot" template (ptcspn.dot for Project Notes, ptcssn.dot for System Notes)
    • Create a new blank document based on that template, and proceed from there.

    ptcspn.doc (pdf version) and ptcssn.doc (pdf version)

    provide examples and more details.

    To create a Project or System Note using LaTeX

    • Take a copy of the appropriate ".sty" style file (ptcspn.sty for Project Notes, ptcssn.sty for System Notes)
    • Take a copy of the example ".tex" file (ptcspn.tex for Project Notes, ptcssn.tex for System Notes)
    • Save this file to an appropriate name, and proceed from there.

    ptcspn.tex (pdf version) and ptcssn.tex (pdf version)

    provide examples and more details.

    -- RichardPrestage - 05 Sep 2003


    Topic FormalDocumentation . { View | Diffs | r1.14 | > | r1.13 | > | r1.12 | More }
    Revision r1.1 - 05 Sep 2003 - 23:46 GMT - RichardPrestage
    Revision r1.14 - 07 Oct 2008 - 17:08 GMT - MartyBloss
    Content copyright © 1999-2007 by the contributing authors.
    All material on this collaboration platform is the property of the contributing authors.