How to Read the SEBoK

From SEBoK
Jump to navigation Jump to search

The SEBoK is implemented as a wiki with more than 100 articles about various systems engineering (SE) topics, such as Emergence and System Requirements. Those articles are grouped into 26 knowledge areas, which are further grouped into 7 parts. The underlying engine for the SEBoK wiki, mediawiki, is the same engine used by wikipedia (see http://www.wikipedia.org), but many customizations have been made for the SEBoK. This article explains the special features of the SEBoK wiki implementation and also suggests how you can navigate the SEBoK to find SE information of interest.

Wiki Features

Most of the features of the SEBoK are self-evident to anyone familiar with normal website navigation mechanisms or who has ever use a common wiki such as wikipedia (see http://www.wikipedia.org). Nevertheless, it is worthwhile highlighting the content on the lefthand side of each page, which is always the same and always has four sections:

  • Quicklinks
  • Outline
  • Navigation
  • Toolbox

Quicklinks

The seven quicklinks are hotlinks that are likely to be of main interest to new SEBoK users. You are now looking at one of them, How to Read the SEBoK. The purpose of most of the quicklinks is self-apparent, but of special note is Copyright Information, which explains what you may do with the information found on the SEBoK. All of the information contained in the SEBoK is copyright protected, but can be accessed and viewed without cost by anyone through the Internet. On the other hand, there are restrictions on what you can do with that information beyond access and viewing. Please look at the Copyright Information article for complete information.

Outline

The SEBoK is divided into seven major Parts, each of which is further divided into Knowledge Areas, which are in turn divided into related topics. The hierarchical structure of the SEBoK is represented in the Outline. Conveniently, the Outline auto-expands to show the article you are currently reading.

Navigation

A webpage containing each of the structural elements of the SEBoK can be accessed by clicking the element name; .e.g., clicking on Glossary of Terms takes you to a webpage containing all 365 glossary entries.

Toolbox

Finally, the Toolbox contains links to less commonly accessed features; e.g., as the name implies, What Links Here, takes you to a webpage that shows all the other pages within the SEBoK that link to the page you were just viewing. Readers should rarely need to use the toolbox links.

Starburst

A somewhat more novel navigation feature is the starburst, which allows a user to visualize all of the related information (links) on an article. The starburst is found in the upper right portion of each page. Clicking on it expands the starburst to show all the links that page points to, providing a graphical means to see the linkage relationships.

Finding Information

If you are new to SE, we suggest you begin by visiting Part 1, SEBoK 1.0 Introduction. It provides an excellent overview of the SE discipline, the history of SE, and other useful insights. Note that every topic has one or more primary references, which are those readings the SEBoK authors believe are the best generally available coverage of that topic. For example, the topic Systems Engineering Overview suggests the INCOSE Systems Engineering Handbook as an excellent introduction to SE, and the topic Economic Value of Systems Engineering recommends three articles by authors Boehm, Honour, and Valerdi as "must reads". Each primary reference has its own webpage which provides full citation information, indicates all the articles that cite it, and, in many cases, elaborates on its content. You can browse through the entire set of more than 200 primary references at Primary References. Similarly, the SEBoK defines more than 350 important glossary terms, such as architecture and verification. When you read an article that uses one of these terms, it will generally be a hotlink that will take you to a separate webpage which contains one or more definitions for the term, the source for each definition, and other places in the SEBoK that also link to that webpage. You can browse the entire glossary at Glossary of Terms.

If you are already familiar with SE and want to look for a specific topic, you have several options available. First, you can type the word or phrase in the search box at the top right hand corner of any page, hit "Go", and view the results to see where in the SEBoK you can find the sought after information. You can also use the outline structure of the SEBoK, shown on the left-hand side of every page, to select a specific part, knowledge area, or topic. Still another approach is to read the use cases called out in SEBoK Users and Uses in Part 1, which suggest ways in which you might find valuable information for different purposes.

Article Format

Each article has the same basic structure.

At the top is an introduction to the article content, followed by the table of contents of the article, followed by sections containing the main body of information in the article. To aid readability, articles are generally no longer than 2000 words. Most articles contain hyperlinks to other articles, glossary terms, primary references, and even to external websites outside the SEBoK.

Towards the bottom of each article are the References, which are divided into works cited, primary references, and additional references. Works cited, as the name implies, are simply the full citations for articles, books, and websites found in the article. As described earlier, primary references are readings that the SEBoK authors recommend anyone who wishes to know about the topic read. Finally, additional references are readings that the SEBoK authors think are worthwhile for you to read beyond the primary references if you want to learn about the topic in greater depth.

At the end of each article is a DISQUS segment where you can enter comments about the article, such as possible improvements or corrections or where you can simply state your opinion about what you read. Because DISQUS supports threaded comments, you can also reply to previously posted comments.

You can also vote whether you like the article, using the familiar Facebook interface.

The SEBoK editors will monitor all of your comments and suggestions to use when planning periodic updates to the SEBoK.

SEBoK v. 1.0 Discussion

Please provide your comments and feedback on SEBoK v. 1.0 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 (click "DISQUS" button). Feedback will be archived and used for future updates to the SEBoK.

blog comments powered by Disqus