nfoWorks
 

c080201 nfoWorks Construction Note
Site Bootstrapping

nfoWorks>construction>
2008>02>

c080201>
0.01 2016-05-09 09:46 -0700


This is the first time that this bootstrapping approach has been used to make a fresh nfoCentrale site.  The manual results will be captured with an eye toward automating the creation of new sites as much as possible.  It is also desirable to find ways to automate the repaving of existing sites when style and format requirements change (e.g., for accessibility and use of current web standards).  There are a number of repaving projects underway and some computer-based assistance at that is also desired.

 

visits to popular nfoWorks pages

Locations of visitors to nfoWorks

1. Bootstrapping
2. Work Items and Bootstrap Progress
3. Reporting Defects
4. Making Insertions
5. Related Material

 

1. Bootstrapping

nfoWorks is a new family of domains and web sites: nfoWorks.com, nfoWorks.net, and nfoWorks.org.  Most nfoWorks material is found at nfoWorks.org; unqualifed references to nfoWorks are generally to that site (this site).

Bootstrapping of nfoWorks involves creating a basic site with the minimal structure that is used for all nfoCentrale sites.  The minimal structure provides scaffolding on which the unique content for nfoWorks can then be developed and maintained in a systematic way.

Bootstrapping starts by populating an initial site with folders and pages for the basic construction structure and construction materials needed for further development.  Initial "placeholder" material is borrowed from existing sites that already have the desired structure.  The basic infrastructure of the site is arranged first:

nfoWorks.org / ---   root construction structure and root construction zone
                |
                -- _private/
                |
                -- cgi-bin/
(not viewable)
                |
                -- construction/
                |
                -- images/

 

The infrastructure is used and extended as the main content is introduced.  In order to allow preliminary content to be organized as soon as possible, we quickly provide a place for compilation of notes and initial content.  For nfoWorks, that is by early provision of

                |
                -- notes/

This is the place for early nfoWorks content including preliminary notes.

Bootstrapping continues by progressively customizing placeholder material into the form required for nfoWorks.

Bootstrapping is a manual process.  In order to keep track of the bootstrap status and progress, notices are placed throughout the construction structure and in lists of work items (e.g., on any Job Jar & Diary page) that reflect the local bootstrapping (and later-maintenance) status.  This serves three important purposes:

The customization process begins at the front porch of the site.  It is propagated from there down into the infrastructure and content sections as they are introduced.  The complete bootstrapping progress of all components of the site can be reviewed by navigation from the root construction structure page.

When bootstrapping is completed, the overall site status is elevated to the Hard Hat Stage.  That stage lasts until the infrastructure is covered over everywhere by an appropriate facade and accomplishment of a professional appearance for the site.  After the hard hat stage, the plumbing and scaffolding is no longer imposed on visitors, although it remains as part of the support for the site.

2. Work Items and Bootstrap Progress

There is a progression of work items being followed to extend the construction structure information through all of the initial folders.  This can be found in the top-level construction zone Diary & Job Jar table. 

Essentially, the initial material is adjusted starting from the root of the site and working to the leaves of the initial folders.  As the material is customized, notices are inserted in the pages of infrastructure to reflect their bootstrapping status.  

The initial notice is in red text.  It indicates that the transformation to the correct form and content is incomplete.

As construction structure and construction materials are customized for this site, the notices in the material are changed to ones with green text.  These notices indicate which aspect of the material at that point and below is now in correct form: construction structure and content material.

For new material that is introduced following the initial bootstrap, a different green-text notice is used to indicate that this material is created in the proper form from the beginning. 

The different notices and their usage are illustrated here on the 2008-02-18 Announcement page.

3. Reporting Defects 

Any defect encountered in nfoWorks content, construction structure, and links (internal and external) can be reported to the nfoWorks coordinator

If you are curious what defects are already identified, you can inspect the lists of known work items that are maintained throughout the site:

Out beyond the bootstrapping stage, there will be defect tracking and maintenance for software that is developed or relied upon in nfoWorks projects.  There will be special mailing lists for use of those who want to report or to know about software defects and their resolution.

All comments and questions related to nfoWorks are welcome.  It is not necessary to use any formal submission process, although that may be beneficial to ensure that your concerns are noticed quickly and addressed by those who are working directly on nfoWorks projects.

4. Making Insertions

Using Microsoft Office FrontPage 2003, the current announcement may be inserted into any number of site pages.  Insertion is by using the FrontPage extensions "Include Page" web component.  The FrontPage operation is performed using the current Include Page.  That Include Page provides a single-cell table element that accomplishes three purposes:

  1. The announcement provides a link to a document-engineering page (such as this one) where more detail of the repaving-project status may be found. 

  2. The FrontPage 2003 Hyperlinks View provides a way to know where the announcement is currently placed as it is appropriate to remove it from some pages and add it to others.

  3. Maintenance of the insertion is performed in a single place and automatically reflected in all of the places the announcement has been inserted.

The link in the caption beneath the cell provides access to the corresponding document-engineering page and its explanation.

For further information on how this approach to Include Content is performed, see the template article page c000006c: ClustrMap Insertion FrontPage Document Engineering.

5. Related Material


Attribution:
Hamilton, Dennis E.
nfoWorks Site Bootstrapping.   nfoWorks Construction Note  c080201 0.01, March 10, 2008.  Available at <http://nfoWorks.org/construction/2008/02/c080201.htm>.
Revision History:
0.01 2008-03-10-21:41 Customized for nfoWorks Bootstrap
The content of this page is revised to reflect the bootstrapping project for nfoWorks.
0.00 2008-02-17-12:37 Create Folio Cover-Page Placeholder
Customize just enough for nfoWorks bootstrapping use.  Clean it up after that.

Construction Structure (Hard Hat Area)
Creative Commons License You are navigating nfoWorks construction material.
This work is licensed under a
Creative Commons Attribution 2.5 License.

created 2008-02-17-12:37 -0800 (pst) by orcmid
$$Author: Orcmid $
$$Date: 16-05-09 9:46 $
$$Revision: 148 $