Documenting Template Builds - Tamberra
Here at Tamberra, we see ourselves as professional digital problem solvers. We love a good mystery and that is what your project might be at this stage… a mystery. Who, what, where, when, why – these are all questions that we can help you answer.
Tampa, Web Development, Web Developers, Web Applications, Tampa Bay, Programmers, Newspaper Web Developer
6008
post-template-default,single,single-post,postid-6008,single-format-standard,do-etfw,ajax_fade,page_not_loaded,,vertical_menu_enabled,side_area_uncovered_from_content,qode-theme-ver-7.5,wpb-js-composer js-comp-ver-5.1,vc_responsive

Documenting Template Builds

Documentation

13 Nov Documenting Template Builds

Oh, documentation: The first thing that gets cut when timelines shorten, the last things developers want to write, and the first thing we need when picking up a new project or joining a new team.

 

There are always extremes. The minimalist says, “The code IS the documentation.” On the other extreme is the developer who documents every minor thing and takes twice as long as it took to code the thing; all for documentation that will need to change within a week of writing it.

 

Tamberra has developed a happy medium: Template Maps.

 

We use template maps to quickly draw out which tags and object files we use to create a new feature. We create them for those custom CCE modules, photo galleries, or any feature that is not immediately obvious how it was constructed.

 

 

Template mapSo what is a template map? See the image to the left for an example of a simple template map for a Google News Sitemap implementation.

 

As atlassian fans, we usually upload these documents to our Confluence wiki and make them available to everyone on the dev team. Now any developer can generally look for a template map and immediately see on one diagram where all the files are located and any js/css assets needed. We also include any localdata.ini settings and publicus.ini settings necessary to make the feature work.

 

Template maps are always part of the package when we do custom development for a client. They allow developers to quickly understand how a module/feature was built in the SAXOTECH / NEWSCYCLE templates.

 

How do you document your work on your development teams?

 

Stacey Jenkins

Stacey Jenkins

Stacey has 15+ years of project implementations under her belt. From very large to very small, she has managed, analyzed, built, and tested systems and then trained teams how to use them. Specifics are on her linkedin, but at the end of the day, Stacey enjoys building things that give real value to the business at hand. She loves this stuff.
Stacey Jenkins