Skip to content

Update issue-workflow.md#603

Open
GordonLtron wants to merge 1 commit into
tronprotocol:masterfrom
GordonLtron:Issue-Specification-and-Guidelines
Open

Update issue-workflow.md#603
GordonLtron wants to merge 1 commit into
tronprotocol:masterfrom
GordonLtron:Issue-Specification-and-Guidelines

Conversation

@GordonLtron
Copy link
Copy Markdown
Contributor

Review of Issue Specification and Guidelines

This document contains several careless copy-paste artifacts and missing punctuation marks that must be fixed before merging. The current state is unpolished and unprofessional.

  1. Fix Missing Punctuation: Multiple sentences are mashed together without periods. Add periods in the following locations:

    • Change ...as an Issue Participating in... to ...as an issue. Participating in...
    • Change ...submit an Issue Please follow... to ...submit an issue. Please follow...
    • Add a period at the end of the "Assigning Issues" bullet point: ...discussion of the issue.
  2. Standardize Capitalization: Avoid randomly capitalizing the word Bug in the middle of sentences. Change it to lowercase bug throughout the text (e.g., find a bug, reproduce the bug). It is also recommended to use lowercase issue when referring to the general concept rather than a specific UI element.

Please revise the document to ensure basic structural integrity.

**Review of Issue Specification and Guidelines**

This document contains several careless copy-paste artifacts and missing punctuation marks that must be fixed before merging. The current state is unpolished and unprofessional.

**Required Changes (Confidence Level: High):**

1. **Remove Web Anchor Artifacts:**
   Delete all instances of the `¶` symbol from the headers (e.g., `Issue Specification and Guidelines¶`, `Submitting an Issue¶`, `1. Search Existing Issues¶`). These are leftover artifacts from copying HTML content.

2. **Fix Missing Punctuation:**
   Multiple sentences are mashed together without periods. Add periods in the following locations:
   * Change `...as an Issue Participating in...` to `...as an issue. Participating in...`
   * Change `...submit an Issue Please follow...` to `...submit an issue. Please follow...`
   * Add a period at the end of the "Assigning Issues" bullet point: `...discussion of the issue.`

3. **Add Delimiters to List Items:**
   The bullet points under "Choose and Submit an Issue Type" and "Issue Handling Process" run the titles directly into the descriptions. You must add a colon (`:`) or a line break to separate them.
   * *Example:* Change `Ask a question Please describe...` to `**Ask a question:** Please describe...`
   * *Example:* Change `Tagging Issues New issues...` to `**Tagging Issues:** New issues...`

4. **Standardize Capitalization:**
   Avoid randomly capitalizing the word `Bug` in the middle of sentences. Change it to lowercase `bug` throughout the text (e.g., `find a bug`, `reproduce the bug`). It is also recommended to use lowercase `issue` when referring to the general concept rather than a specific UI element.

Please revise the document to ensure basic structural integrity.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant