Organization of files

I have been trying to work on my action item for the personalization task force.  My understanding is that we want to separate the help and support terms and descriptions from the actual examples.  That seems easy enough except that it appears that I can only import an entire file via the data-include attribute.  Thus, in order to separate out the different sections, I need to split apart the files for each of the help types (alternative.html, easylang.html, etc).  Please correct me if I am wrong. 


For example, alternative.html would become alternative-desc.html, and alternative-example.html.  That also raises the question of where do the list of values applicable to each term belong? Currently the values are listed within the characteristcs  with the example because the examples assume an attribute/value pair.

Should I go ahead and split up each of the appropriate files within the help subdirectory into two separate files? I would use the <filename>-desc.html and <filename>-example.html naming convention?  The <filename>.html can be pull in the two separate pieces into the whole (although I haven’t quite figured out how, yet). I would be happy to use a different approach.

My idea for the organization for section 3, Vocabulary, of the help and support document is:

3 Vocabulary (may need to change this term)
General Description

3.1 Alternative
Alternative description 

3.x <term>
<term> description

4 Values (May need to change this term)
Values description

Values table (currently listed under 3.4.4 and 3.4.9 - I suggest putting them all in one place and referencing them as needed)

5 Examples
5.1 Alternative example
5.1.1 Alternative Characteristics (where needed) include the supported values within the characteristics.

5.2 <term> Example

I tried to change the files around to show this for one example but I am not enjoying learning the w3c/respec rules. 

-becky

Received on Friday, 1 June 2018 23:31:49 UTC