Skip to content

Commit 77d3c6b

Browse files
committed
Update guidelines.md
fix line length Signed-off-by: Andrés Vega <av@messier42.com> Signed-off-by: Andres Vega <av@monkey.org> Update guidelines.md fix line brakes and spacing Signed-off-by: Andrés Vega <av@messier42.com> Signed-off-by: Andres Vega <av@monkey.org> Update guidelines.md fix trailing spaces and heading spacing Signed-off-by: Andrés Vega <av@messier42.com> Signed-off-by: Andres Vega <av@monkey.org> Update guidelines.md trailing space Signed-off-by: Andrés Vega <av@messier42.com>
1 parent b11c198 commit 77d3c6b

File tree

1 file changed

+15
-3
lines changed

1 file changed

+15
-3
lines changed

publications/guidelines.md

+15-3
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,60 @@
11
# Publishing Guidelines and Standards
22

3-
The purpose of these guidelines is to ensure the production of high-quality, consistent, and impactful publications. Most pieces are authored as collaborative knowledge production efforts within working groups, under the guidance of a chair or technical leader. The topics tend to be sharp under the purview of a working group, for instance, “Software Supply Chain Best Practices,” “Secure Software Factory,” or “Open and Secure - A Manual for Practicing Threat Modeling to Assess and Fortify Open Source Security,” but sometimes cover broader themes like cloud native security white papers, the lexicon, and use cases and personas.
3+
The purpose of these guidelines is to ensure the production of high-quality, consistent, and impactful publications. Most pieces are authored as collaborative knowledge production efforts within working groups, under the guidance of a chair or technical leader.
4+
The topics tend to be sharp under the purview of a working group, for instance, “Software Supply Chain Best Practices,” “Secure Software Factory,” or “Open and Secure - A Manual for Practicing Threat Modeling to Assess and Fortify Open Source Security,” but sometimes cover broader themes like cloud native security white papers, the lexicon, and use cases and personas.
45

5-
We strive for quality over quantity, emphasizing the importance of not duplicating existing materials unless we have something new to contribute or a cloud native perspective to offer. While some of our publications serve as "tour guides" rather than comprehensive handbooks, there is a recognized need for more in-depth books on building security that are regularly updated. These guidelines aim to foster a rigorous, clear, and professional standard for all our publications, ensuring they remain valuable resources for the community.
6+
We strive for quality over quantity, emphasizing the importance of not duplicating existing materials unless we have something new to contribute or a cloud native perspective to offer.
7+
While some of our publications serve as "tour guides" rather than comprehensive handbooks, there is a recognized need for more in-depth books on building security that are regularly updated. These guidelines aim to foster a rigorous, clear, and professional standard for all our publications, ensuring they remain valuable resources for the community.
68

7-
We intentionally maintain a low-friction, low-barrier approach to publishing to keep these efforts enjoyable and accessible. However, we ask authors to consider these guidelines upfront, as the proofing and editorial work often involves significant effort from volunteers. Unlike professionals at a publishing house, these volunteers juggle these tasks alongside their regular commitments. To ease this burden, we encourage authors to strive for the highest quality in their initial drafts, ensuring clarity, accuracy, and coherence from the start. This consideration helps make the collaborative process more efficient and enjoyable for everyone involved.
9+
We intentionally maintain a low-friction, low-barrier approach to publishing to keep these efforts enjoyable and accessible.
10+
However, we ask authors to consider these guidelines upfront, as the proofing and editorial work often involves significant effort from volunteers. Unlike professionals at a publishing house, these volunteers juggle these tasks alongside their regular commitments. To ease this burden, we encourage authors to strive for the highest quality in their initial drafts, ensuring clarity, accuracy, and coherence from the start.
11+
This consideration helps make the collaborative process more efficient and enjoyable for everyone involved.
812

913
## Initial Publishing Guidelines and Standards
1014

1115
### 1. Content Quality
16+
1217
- **Relevance**: Ensure all content is relevant to the topic and objectives of the publication.
1318
- **Accuracy**: Verify all facts, figures, and citations. Ensure all information is current and correct.
1419
- **Comprehensiveness**: Cover the topic thoroughly, providing a clear and complete picture. Avoid unnecessary jargon and ensure the content is accessible to the target audience.
1520
- **Clarity and Coherence**: Maintain a logical flow of ideas. Ensure that each section transitions smoothly to the next and that the overall structure supports the document’s objectives.
1621

1722
### 2. Structure and Organization
23+
1824
- **Title and Abstract**: Provide a clear, concise title and abstract that summarize the main points and objectives.
1925
- **Sections and Headings**: Use clear and descriptive headings. Ensure that the document is divided into well-defined sections (e.g., Introduction, Background, Core Concepts, Implementation, Case Studies, Conclusion).
2026
- **Introduction**: Offer a compelling introduction that outlines the purpose and scope of the document.
2127
- **Conclusion**: Summarize key findings and provide actionable recommendations or next steps.
2228

2329
### 3. Writing Style
30+
2431
- **Tone**: Maintain a professional and objective tone throughout the document.
2532
- **Clarity**: Write in clear, concise language. Avoid ambiguity and redundancy.
2633
- **Consistency**: Ensure consistency in terminology, abbreviations, and formatting.
2734

2835
### 4. Technical Accuracy
36+
2937
- **Terminology**: Use industry-standard terminology correctly. Provide definitions for any specialized terms or acronyms.
3038
- **Examples and Diagrams**: Include relevant examples and diagrams to illustrate key points. Ensure that all visuals are clearly labeled and referenced in the text.
3139

3240
### 5. Technical Rigor
41+
3342
- **Depth of Analysis**: Provide in-depth analysis and discussion of the topic. Ensure that technical concepts are explained thoroughly and accurately.
3443
- **Methodology**: Clearly describe the methodologies and frameworks used. Ensure that the approaches are scientifically sound and justified.
3544
- **Evidence and Data**: Support arguments with robust evidence and data. Include empirical data, case studies, or examples to substantiate claims.
3645

3746
### 6. References and Citations
47+
3848
- **Source Quality**: Use reputable and reliable sources. Ensure that all references are properly cited.
3949
- **Citation Format**: Adopt a consistent citation style (e.g., APA, IEEE). Include a comprehensive references section at the end of the document.
4050

4151
### 7. Review and Revision
52+
4253
- **Peer Review**: Submit the document for peer review by knowledgeable individuals within the consortium. Incorporate feedback and revisions as needed.
4354
- **Proofreading**: Conduct thorough proofreading to eliminate grammatical, typographical, and formatting errors.
4455

4556
### 8. Formatting and Presentation
57+
4658
- **Document Layout**: Use a clean and professional layout. Ensure consistent use of fonts, headings, and spacing.
4759
- **Figures and Tables**: Number all figures and tables sequentially. Provide clear captions and ensure they are referenced in the text.
4860
- **Appendices**: Include appendices for supplementary material that supports the main content without interrupting the flow.

0 commit comments

Comments
 (0)