Editor's Corner

From SEBoK
Jump to navigation Jump to search

Please note that in order to provide review comments, you will use the DISQUS feature at the bottom of each article. You may login to DISQUS using existing accounts (e.g. Google, Yahoo, Twitter, or Facebook) or you may create a DISQUS account. Please look for the BKCASE posts under the discussion for each article, which provide specific guidance for reviewers.

Overview

BKCASE (pronounced "Bookcase") is the acronym for the Body of Knowledge and Curriculum to Advance Systems Engineering project. The BKCASE team is developing two products, a Guide to the Systems Engineering Body of Knowledge (SEBoK) and a Graduate Reference Curriculum for Systems Engineering (GRCSE).

The current content of www.sebokwiki075.org represents version 0.75 of the SEBoK. To be clear:

  • The SEBoK is not the compendium of all systems engineering knowledge; instead, in its final form it is intended to be the definitive guide to systems engineering (SE) knowledge. To this end, each article has been intentionally limited to about 2000 words (not including references or tables).
  • The materials in version 0.75 should not be considered final.
  • With 0.75, the authors have attempted to improve the consistency in terms of scope and level of detail for each article. However, where reviewers note inconsistency, comments would be extremely helpful.
  • Only some of the articles were updated for 0.75 (see "Articles Updated for SEBoK 0.75") below. All other articles in the wiki are essentially the same as version 0.5 (with minor updates to reflect changes elsewhere).

Version 0.75 offers the public SE community a view into the state of the SEBoK as its authors evolve it towards the September 2012 Version 1.0 release. Most importantly, the authors are soliciting comments from the community to improve the content for version 1.0. The ideal outcome is that the SEBoK will be supported worldwide by the SE community as the authoritative BoK for the SE discipline.

State of the SEBoK

Summarizing the current state of the SEBoK at this point, the SEBoK team believes the following:

  1. The SEBoK is more mature than version 0.5. The quality of the writing, the choice of topics, the architecture of the SEBoK, and the completeness of the writing have been improved over version 0.5. The author team is quite proud of how far the SEBoK has come. Yet, the choice of version "0.75" does reflect the fact that much more work remains before the SEBoK will be fully ready for broad use and adoption.
  2. The architecture of the SEBoK into parts, knowledge areas, and topics is fundamentally correct and will persist in version 1.0, although there may be some minor adjustments.
  3. The choice of primary references - considered the most important readings in the field for a given topic - is immature. Reviewer feedback to help mature those choices is especially vital.
  4. Integration among articles is better than in version 0.5, but much remains to be done.
  5. Even though the articles in the wiki have been edited, there are still shortcomings in the writing. Nevertheless, version 0.75 captures extremely valuable information about the field, and provides a solid foundation for the final version.
  6. Moving to a wiki environment for the development and delivery of the SEBoK has been a huge step for the authors, but well worth it.

Reviewers will provide an external check on these beliefs.

Articles Updated for SEBoK 0.75

The following is the list of articles that have been heavily revised in the transition from SEBoK 0.5 to SEBoK 0.75 or are new articles entirely. Many of these updates were done in response to the SEBok 0.5 reviews (please see the Adjudication Report for additional information). Reviewers are welcome to comment on all articles, not only the ones updated for SEBok 0.75.

About the SEBok 0.75 Review

This is the third phase of SEBoK reviews. The first review of version 0.25 was completed with a limited audience of reviewers in Fall 2010. The report on the 0.25 comments can be found here.

The second review of version 0.5 was open worldwide in Fall 2011; an additional review was conducted by INCOSE working groups (WGs) in association with the INCOSE International Workshop. For comments received in the 0.5 wiki, the comments and any author actions to date can be viewed on each page under the heading "Comments from 0.5 Wiki." For comments received outside the wiki, please view the adjudication report here.

The third review, of version 0.75, is open to the public; the deadline for reviewer comments is April 15, 2012.

In version 0.25, the guide was presented as a PDF document with sixteen chapters. Version 0.5 was presented in a wiki. Version 0.75 is also presented in a wiki with seven major parts, 28 knowledge areas, and about 160 total articles with hyperlinks between articles and to a set of primary references, a glossary, and a list of acronyms. (Please see Reading the SEBoK for a detailed explanation of the different article types.) The review of version 0.75 will use embedded discussion functionality for each article.

Review Process

The SEBoK version 0.75 review process is intended to provide the SE community an opportunity to comment on the approach, provide feedback on current draft content, provide feedback on the wiki format, and make recommendations about future content and wiki features. The author team recommends that all reviewers read Part 1: SEBoK 0.75 Introduction including the complete set of Part 1 articles, which provide the context for the rest of the materials. In addition, reviewers are encouraged to review the materials most relevant to their current roles or interests.

Please note that in order to provide review comments, you will use the DISQUS feature at the bottom of each article. You may login to DISQUS using existing accounts (e.g. Google, Yahoo, Twitter, or Facebook) or you may create a DISQUS account. Please look for the BKCASE posts under the discussion for each article, which provide specific prompts for reviewers to consider.

Two types of input requested

There are two forms of reviewer feedback:

  1. Each of the articles has a set of discussion prompts in the embedded discussion at the bottom of the page. Reviewers are asked to consider these prompts as they conduct their reviews.
  2. The word document SEBoK 0.75 Review Form is provided to collect specific comments on the overall SEBoK and the wiki. Please provide responses by question number and return the document to bkcase@stevens.edu.

Please note that reviewers may download a PDF of SEBoK 0.75 click here or may download a specific Part for review by going to Download SEBoK PDF. Please note that this is a large file (~50 MB) and so may take several minutes to download.

Thank you

The opinions and constructive criticism the BKCASE author team receives from you, the reviewer, plays an extremely valuable and important role in the worldwide success and acceptance of SEBoK. If you would like to obtain further project information, please visit the project’s website at bkcase.org and if you have any questions during your review, please contact us at bkcase@stevens.edu.

The BKCASE author team sincerely thanks you for volunteering your time to help us with this important effort.

~The BKCASE Team

bkcase@stevens.edu

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