Gdy już gotowe są przykładowe pliki z treścią, można utworzyć plik spisu treści (toc). Plik spisu treści definiuje kluczowe punkty wejścia do plików HTML, odwzorowując etykietę tematu pomocy na odwołanie w jednym z tych plików.
Aplikacje migrowane do platformy mogą korzystać z istniejącej dokumentacji, używając pliku spisu treści do definiowania punktów wejścia do tej dokumentacji.
Moduł dodatkowy może mieć jeden lub więcej plików spisu treści. Przykładowa dokumentacja jest podzielona na trzy kategorie: pojęcia, czynności i odwołania. W jaki sposób przygotować pliki spisu treści reprezentujące taką strukturę?
Dla każdej głównej kategorii można utworzyć oddzielny plik spisu treści lub można utworzyć jeden duży plik. Ta decyzja powinna zostać podjęta w zależności od sposobu wspólnej pracy zespołów zajmujących się dokumentacją. Jeśli każdą kategorią zajmuje się inny autor, warto zachować oddzielne pliki spisu treści dla każdej z nich. Ta kwestia nie jest narzucana przez architekturę platformy.
W tym przykładzie zostanie utworzony plik spisu treści dla każdej głównej kategorii treści. Tworzenie dla każdej kategorii oddzielnych plików spisu treści zawierających tak małą liczbę plików nie jest konieczne. Przykład zostanie tak zbudowany, jakby w dokumentacji było bardzo dużo plików lub jakby oddzielni autorzy zajmowali się poszczególnymi kategoriami.
Pliki będą wyglądały w następujący sposób:
<toc label="Concepts"> <topic label="Concept1" href="html/concepts/concept1.html"> <topic label="Concept1_1" href="html/concepts/concept1_1.html"/> <topic label="Concept1_2" href="html/concepts/concept1_2.html"/> </topic> </toc>
<toc label="Tasks"> <topic id="plainTasks" label="Plain Stuff"> <topic label="Task1" href="html/tasks/task1.html"/> <topic label="Task2" href="html/tasks/task2.html"/> </topic> <topic id="funTasks" label="Fun Stuff" > <topic label="Task3_1" href="html/tasks/task3_1.html"/> <topic label="Task3_2" href="html/tasks/task3_2.html"/> </topic> </toc>
<toc label="Reference"> <topic label="Ref1" href="html/ref/ref1.html"/> <topic label="Ref2" href="html/ref/ref2.html"/> </toc>
Temat pomocy może być prostym odwołaniem do treści. Pozycja "Task1" udostępnia element label (etykieta) i element href (odwołanie) łączący z treścią. Temat pomocy może również grupować hierarchicznie podtematy bez odwoływania się do konkretnego miejsca w treści. Pozycja "Fun Stuff" na przykład zawiera element label (etykieta) oraz podtematy, ale nie zawiera elementu href (odwołanie). Tematy pomocy mogą pełnić obie funkcje jednocześnie. Pozycja "Concept1" zawiera jednocześnie elementy href (odwołanie) i podtematy.