How to Read the SEBoK

From SEBoK
Jump to navigation Jump to search

The SEBoK is a collection of several different types of articles, which are organized around central themes. There are three different articles types:

  • Content Articles - these are the articles that comprise the main body of the SEBoK (please see Structure of the SEBoK for an explanation of the organization or SEBoK Table of Contents for the full table of contents);
  • Glossary Articles - each glossary term has its own article, which is intended to provide a place for definition, definition sources, and discussion that reflects the state of practice for using this term in the community; and
  • Primary Reference Articles - each primary reference (or reference identified as critically important) has it's own article, which provides the full bibliographic information for that source, lists the article(s) which consider the source a primary reference, and provides discussion on why the source is important for each of these articles.

For every article in the wiki, reviewers have an opportunity to provide feedback using the "discussion" tab located at the top of the page. Below are a series of screen shots showing the different types of wiki articles and what the review pages look like. (Please see Note to Reviewers for more information on reviewing SEBoK 0.75.)

Content Article

The following is an example of a content article, showing the different types of information contained in each article.

SEBoK ArticleExplanation.png

Glossary Article

The following is an example of a glossary article, showing the different types of information contained in each article.

SEBoK GlossaryExplanation.png

Primary Reference Article

The following is an example of a primary reference article, showing the different types of information contained in each article.

SEBoK PrimRefExplanation.png

Review/Discussion Threads

Please note that in order to provide review comments, you must first log in to the wiki. Please go to Login or create an account if you do not have a username (less than 1 minute).

The following is screen shot of how the discussion threads will appear for reviewers. These threads will be used to capture feedback on SEBoK 0.75.

SEBoK DiscussionExplanation.png


SEBoK v. 1.9.1 released 30 September 2018

SEBoK Discussion

Please provide your comments and feedback on the SEBoK below. You will need to log in to DISQUS using an existing account (e.g. Yahoo, Google, Facebook, Twitter, etc.) or create a DISQUS account. Simply type your comment in the text field below and DISQUS will guide you through the login or registration steps. Feedback will be archived and used for future updates to the SEBoK. If you provided a comment that is no longer listed, that comment has been adjudicated. You can view adjudication for comments submitted prior to SEBoK v. 1.0 at SEBoK Review and Adjudication. Later comments are addressed and changes are summarized in the Letter from the Editor and Acknowledgements and Release History.

If you would like to provide edits on this article, recommend new content, or make comments on the SEBoK as a whole, please see the SEBoK Sandbox.

blog comments powered by Disqus