Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve git versioning and releases #964

Closed
16 tasks done
commjoen opened this issue Aug 7, 2018 · 7 comments
Closed
16 tasks done

Improve git versioning and releases #964

commjoen opened this issue Aug 7, 2018 · 7 comments
Assignees
Projects
Milestone

Comments

@commjoen
Copy link
Collaborator

commjoen commented Aug 7, 2018

We need to improve the versioning and release strategy (git tags and releases) of the mstg and masvs to make them easier to use by other organisations.

  • 1. have a clear versioning strategy for MASVS & MSTG
  • - Versions
  • - change-history required? (yes: has to be included in git)
  • - Tagging of MSTG
  • 2. automate releasing new pdfs and zip files with travis for the MSTG per tag:
    • Pandoc update with tag & TOC in document & changelog
    • pdf update with
      • fix new page after before h1 starts,
      • fix/add TOC,
      • add changelog,
      • Fix date to version-tag,
      • Fix page numering
    • automatic update of gitbook
  • 3. Apply milestoning on issues to prioritize
  • 4. Include a contribution guide which is shown at pull-requests - PULL_REQUEST_TEMPLATE.md: 1. active voice, 2. 2nd person, 3. update references, 4. proper markdown & code, 5. urls? use the following: [TEXT](URL “NAME”) 6. have you tested & verified the effectiveness of your writing?
  • 5. Include markdown linting and stuff (and make sure 2. will run at every PR)

Redo this for MASVS.

@commjoen commjoen added this to To do in OWASP MSTG via automation Aug 7, 2018
@commjoen commjoen self-assigned this Aug 7, 2018
@commjoen commjoen changed the title Improve git versiversioning and releases Improve git versioning and releases Aug 7, 2018
@commjoen
Copy link
Collaborator Author

For both MASVS & MSTG we will use the following versioning strategy: We will use semantic versioning:
major.minor.patch

  • ticket merged: patch : +1
    patches can be grouped per day to simplify it a bit
  • for ever half year: minor +1
  • for every complete rewrite: major +1

@commjoen
Copy link
Collaborator Author

For Travis integration and gitbook integration, we need admin rights: #967.

@commjoen
Copy link
Collaborator Author

For changes: include a version history file from here onward.

@commjoen commjoen modified the milestone: 1.1 Release Aug 10, 2018
@commjoen commjoen moved this from To do to In progress in OWASP MSTG Aug 10, 2018
@commjoen
Copy link
Collaborator Author

commjoen commented Aug 10, 2018

  • Include a contribution guide which is shown at pull-requests: 1. active voice, 2. 2nd person, 3. update references, 4. proper markdown, 5. urls? use the following: [TEXT](URL “NAME”)

@commjoen
Copy link
Collaborator Author

test.pdf
First version based on commit b66fb59 . @TheDauntless & @clviper & @sushi2k can you please check what you are missing given the current markdown content?

@commjoen
Copy link
Collaborator Author

commjoen commented Sep 2, 2018

MSTG.docx
New word doc with slightly better contents...

commjoen added a commit that referenced this issue Sep 3, 2018
commjoen added a commit that referenced this issue Sep 4, 2018
commjoen added a commit that referenced this issue Sep 4, 2018
This is part of the 964 issue. The rest will be in the 964/versioning_releasing branch and the license branch
commjoen added a commit that referenced this issue Sep 4, 2018
Added license to make usage more clear.
commjoen added a commit that referenced this issue Sep 4, 2018
commjoen added a commit that referenced this issue Sep 5, 2018
commjoen added a commit that referenced this issue Sep 5, 2018
commjoen added a commit that referenced this issue Sep 5, 2018
commjoen added a commit that referenced this issue Sep 6, 2018
commjoen added a commit that referenced this issue Sep 6, 2018
commjoen added a commit that referenced this issue Sep 6, 2018
commjoen added a commit that referenced this issue Sep 11, 2018
commjoen added a commit that referenced this issue Sep 14, 2018
commjoen added a commit that referenced this issue Sep 14, 2018
commjoen added a commit that referenced this issue Sep 14, 2018
commjoen added a commit that referenced this issue Sep 14, 2018
commjoen added a commit that referenced this issue Sep 14, 2018
commjoen added a commit that referenced this issue Sep 17, 2018
@commjoen
Copy link
Collaborator Author

Merged and fixed

OWASP MSTG automation moved this from In progress to Done Sep 17, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
OWASP MSTG
  
Done
Development

No branches or pull requests

2 participants