Skip to content

slashsbin/styleguide-todo-grammar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Available Grammar

  • @TODO: Something to be done
  • @FIXME: Bug Report, should be corrected, Marked with 🐛 Commit
  • @CHANGED: Version Changes together with @SINCE DocComment, Usually Marked with 🔥 or ⚡ Commits
  • @XXX: Warn other programmers of problematic or misguiding code
  • @IDEA: A New Idea or Proof-of-Concept, Marked with 💡 Commit
  • @HACK: Workaround or Customer Customizations, Marked with 🎀 Commit
  • @NOTE: Add attention to something Important
  • @REVIEW: Needs to be Audited/Reviewed Immediately, Usually Marked with 🚧 Commit

Bug Report

  1. Add @FIXME Comment above SourceCode where Bug/Exception was Occurred.
  2. Write Additional Information:
    1. Steps to Reproduce the Error
    2. Exception Message and Code
    3. Expected Result
    4. Actual Result
    5. Environment Detail
  3. Mention the Task ID in Format {T###}.
  4. (optional) Add Screenshots in Format {F###}(Phabricator Specific).
  5. Commit the Comments(with 🐛 Emoji), also include Items 2.B, 3 & 4 in Commit Message too.
  6. Award that Task with Manufacturing Defect Token(Phabricator Specific).

Notes

  • Do NOT edit Contents of Vendor files(Composer, Bower, ...).
  • Grammars Should Appear in a List/Window in Your IDE of Choice(PHPStorm).
  • There Must be an Audit for this Bug(Commit) Appear in Phabricator.
  • These Kind of Bug Reports Remain in History of VCS for future References of that Scope of Code.
  • All Attached Files & Commit Reference HashTag will be Referenced in the Phabricator Task View.
  • These Audits May become Tasks Later.
References