General DITA questions

File structure and naming convention

My company is converting to DITA with no CMS (for now).  We are creating a file structure and naming convention and are looking for some best practices to guide us.  We have approximately 10 functional groups of content.  To maximize reuse of topics and to make searching for topics easier, we are wondering if our naming convention should use suffixes or prefixes.  For example if I have sets of task to teach users how to build models should my naming convention begin or end with the t for task (and does this really matter?): t_model_building.dita or model_building_t.dita.

Figure Titles

The tagging structure for a figure has the title on top of the figure.


Looking for a way to get the title under the figure keeping the auot numbering  without having to modify the DTD. 

Keeping content in a file from being searchable by search engines

We have a help project that we don't necessarily want the contents of to be discoverable by search engines. Is there some code that can help us accomplish this? I know that keywords and indexterms help improve visibility, but we want the opposite. Any suggestions?

DITA Style Guide



We have recently started using DITA as our authoring tool for creating documents. We have been searching for an online free version of the DITA Style Guide that can be used as a reference.

I would really appreciate if you can share any such Guide/reference.


Thanks in advance!!



Anuj Kapoor 

AutoSaving Records to Appropriate Sharepoint Buckets

I'm trying to alleviate the user painpoint of having to input metadata and/or select a folder in Sharepoint when saving a file by automating this process: creating pre-built, intelligent templates that can be selected to complete...and when the user 'Saves' the file it automatically is directed to the appropriate SharePoint folder (current file types could be MS Word, a PDF, etc.)...wouldn't it be better to create a DITAMAP template instead?...working in a SharePoint environment.

Any ideas? -- many thanks in advance. Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I