Versioning

From Psalms: Layer by Layer
Jump to: navigation, search

Creator Guidelines

Document current version

The versioning system depends on all the Creator Guidelines having milestones. The current version is now the maximum version number (rather than the former Version=x.x specified in each Creator Guidelines page), e.g.

{{Milestone | 55448 |Assumptions Table in Discourse Spreadsheet; updated imagery tables|Sep 2024|1.1}}

Current versions

These Creator Guideliness have the following version:

 Current VersionOverseer
Grammar1.1Ian Atkinson
Verbal Semantics1.0Elizabeth Robar
Story Behind the Psalm1.1Ryan Sikes
Phrase-Level Semantics1.0Ian Atkinson
Close-but-Clear1.0Amanda Jarus
Lexical Semantics1.0Ian Atkinson
Poetic Structure1.0Ryan Sikes
Macrosyntax1.0Ian Atkinson
Speech Act Analysis1.0Ryan Sikes
Exegetical Issues1.0Ryan Sikes
Poetic Features1.0Oobie Weinberg
Participant Analysis1.0Ryan Sikes
Emotional Analysis1.0Ryan Sikes
Synthesis1.0Ryan Sikes
Verse-by-Verse Notes1.0Ryan Sikes

Rubric on the forum

1. Actual forum code that constitutes a rubric is stored in a template, e.g. Template:Rubrics/Grammar.

 |Guardian Review|Overseer Review|Final Checks|Description|
| --- | --- | --- | --- |
||||**Completeness**
|[ ]||| Every word in the psalm is represented in the diagram.
|[ ]|[ ]|| Viable and attested grammatical alternatives are represented in the diagram.
|[ ]|[ ]|| Textual variants, revocalizations, and emendations are represented in the diagram if they are preferred, significant, or attested in modern translations.
|[ ]|[ ]|| Difficulties, alternatives, revocalizations, and emendations are explained with prose notes.|
||||**Quality of analysis**
|[ ]|[ ]||  Every word in the psalm is accurately encoded and diagrammed according to project standards.
|[ ]|[ ]|[ ]|  In the case of difficulties, alternatives, revocalizations, and emendations, each view is thoroughly explained and defended with a note.
|[ ]|[ ]|[ ]|  The preferred view is viable and well grounded in evidence.|
||||**Engagement with secondary literature**
|[ ]|[ ]||  Standard reference grammars (e.g., GKC, JM, IBHS, BHRG) are cited where relevant.
|[ ]|[ ]|[ ]|  Bible translations (ancient and modern) are cited where relevant. When two or more translations reflect a certain interpretation of the grammar, that interpretation is represented on the diagram.|
||||**Clarity of language**
|[ ]|[ ]|[ ]|   Prose notes are clear and concise.
|[ ]|[ ]|[ ]|   Language is not too technical so as to be inaccessible to [Sarah](https://psalms.scriptura.org/w/Personas).|
||||**Formatting/Style**
|[ ]|||   Diagram is properly titled.
|[ ]|||   Each verse in the diagram is properly labeled.
|[ ]|||   The diagrammed text has vowels but no accents or maqqephs.
|[ ]|[ ]||   Proposed changes to the text are properly represented.
|[ ]|[ ]||   Alternatives are properly represented.
|[ ]|[ ]||   Any remaining display problems relating to the diagrammer are flagged for further development.
|[ ]|||   Correct spelling and punctuation are used throughout the prose notes.
|[ ]|||   Notes adhere to the [Style Guide](https://psalms.scriptura.org/w/Style_Guide).| 

2. Within each set of Creator Guidelines, the following code will include the current version (for Grammar, here) in the rubric to be copied onto the forum. (This depends on the rubric content being present in the template, e.g. Template:Rubrics/Grammar.)

{{#tag: pre
|[Grammar Layer Rubric Version {{CurrentVersion|Grammar}}](https://psalms.scriptura.org/w/Grammar#Rubric)
{{Rubrics/Grammar}}
}}

Milestones

These Creator Guideliness have additional milestones (click Expand for a full list). As time progresses, we will distinguish between major milestones (indicating major versions) and minor milestones (indicating minor versions). In general, major milestones are those which indicate a significant rupture, such that it would not be expected that somebody familiar with a previous version could readily understand the next version. A minor milestone, however, would be an aesthetic change or readily understood terminological change.

When a new milestone is reached, it is to be recorded within the Creator Guidelines as an additional line within the Creator Guidelines, as below. The 5-digit number is the "oldid" of the Creator Guidelines when viewing history.

== Previous Versions of these guidelines ==
These are the previous versions of the guidelines that mark significant milestones in our project history. Future versions will be numbered and will correspond to materials approved according to those guidelines.
{{Milestone | 12553 | Logos diagrammer/CGs creation|June 2022}}
{{Milestone | 24685 | First simple code diagrammer |July 2023}}
{{Milestone | 52116 | Second simple code diagrammer |Sept 2024|1.0}}
{{Milestone | 66743 | Straight to wiki |Feb 2025|1.1}}

List of all milestones

 DescriptionDate"Date" is a type and predefined property provided by Semantic MediaWiki to represent date values.Version
Close-but-ClearElided information in square bracketsApril 20230.0
Close-but-ClearClarification regarding use of parentheses and square bracketsAugust 20240.9
Close-but-ClearMaster version of CBC on the forumFebruary 20230.0
Close-but-ClearFirst drafted0.0
Close-but-ClearMaster version of the CBC stored in the Google Docs Discourse SheetSeptember 20241.0
Emotional AnalysisCGs creationOctober 20220.0
Emotional AnalysisColor-coding of Speech Act Summary according to emotionsNovember 20241.0
Emotional AnalysisInclusion of Affective Circumplex; Think-Feel-Do tableApril 20230.0
Emotional AnalysisGoogle Docs Discourse SheetSeptember 20240.9
Exegetical IssuesFuller instructionsAugust 20240.9
Exegetical IssuesLess detailed instructions; no bibliography requiredApril 20230.0
Exegetical IssuesAdded confidence ratings in conclusionJanuary 20251.0
GrammarSecond simple code diagrammer20241.0
GrammarLogos diagrammer/CGs creationJune 20220.0
GrammarFirst simple code diagrammerJuly 20230.9
GrammarStraight to wikiFebruary 20251.1
Lexical SemanticsTagging Reinier to discuss deviations from SDBH included in rubric20230.0
Lexical SemanticsCBC removed from layer and gloss on diagram requiredJuly 20220.0
Lexical SemanticsStep-by-step guidance for SDBH use20240.9
Lexical SemanticsLexical paraphrase is optional; Repeated Roots visual updatedJanuary 20251.0
Lexical SemanticsBeginningJune 20220.0
Lexical SemanticsTheoretical introduction provided by JosephJuly 20230.0
MacrosyntaxIntroduction of vocative positionsMay 20230.9
MacrosyntaxFrame setters and scope of activated topics and discourse markers introducedSeptember 20241.0
MacrosyntaxTables formatOctober 20220.0
MacrosyntaxText formatNovember 20220.0
Participant AnalysisRemoval of Tracking Table and Structural AnalysisMay 20240.9
Participant AnalysisRemoval of using grammatical diagram for tracking; added Tracking Table, Participant sets list, Participant profile notes, and note-format for ambiguitiesDecember 20230.0
Participant AnalysisAll tracking done and added manuallyJuly 20220.0
Participant AnalysisAddition of (3.3) Summary Distribution VisualJanuary 20251.0
Participant AnalysisTracking on grammatical diagram, using diagrammerMay 20230.0
Phrase-Level SemanticsNo more tables; only notesJanuary 20251.0
Phrase-Level SemanticsFuller appendices addedOctober 20220.0
Phrase-Level SemanticsBen's tables incorporatedJune 20240.9
Phrase-Level SemanticsSemantic roles taken outJanuary 20240.0
Phrase-Level SemanticsSemantic roles addedMarch 20230.0
Poetic FeaturesCombination of poetic structure and poetic featuresApril 20230.9
Poetic FeaturesMinor tweaks to clarity of explanation and presentationAugust 20241.0
Poetic StructureCombination of poetic structure and poetic featuresApril 20230.0
Poetic StructureAddition of appendixSeptember 20241.0
Poetic StructureRemoval of line length visualJanuary 20240.9
Speech Act AnalysisSpeech Act Table on MiroAugust 20240.0
Speech Act AnalysisNew color scheme for Speech Act Summary visualNovember 20241.0
Speech Act AnalysisUse of Google Docs Discourse sheet; inclusion of intended perlocutions20240.9
Story Behind the PsalmRubric addedAugust 20230.9
Story Behind the PsalmFirst full version, with propositions and assumptions table, triangles, and Expanded Paraphrase. No imagery.August 20220.0
Story Behind the Psalm(Assumptions Table still on Miro); updated imagery tablesSeptember 20241.0
Story Behind the PsalmAssumptions Table in Discourse Spreadsheet; updated imagery tablesSeptember 20241.1
Story Behind the PsalmImagery table; Common Mistakes addedApril 20230.0
SynthesisProminence removed until more fully developedJanuary 20251.0
... further results

Psalms with approved layers

Each Psalm will have subpages, e.g. Psalm 1/Approvals/Grammar and Psalm 1/Approvals/Lexical, which will contain the current Version and Status, e.g.

  {{Layer
   |Version=0.99
   |Status=Approved
  }}

The status for these is set according to layer.

Grammatical, Lexical and Phrasal

On each Diagrams page is an Appendix with an Approvals section. (E.g. Psalm 1/Diagrams)

Verbal and beyond

When these layers are properly represented on the Resource Site, their pages will have a similar feature.

Actual layers

These are all the layers currently marked with version number and status.