[Fiware-chapter-architects] experience with the architecture deliverable

Alex Glikson GLIKSON at il.ibm.com
Mon Mar 2 23:56:16 CET 2015


Dear coordinator & partners,

I wanted to share my experience working on the architecture deliverable.
Maybe there is a better way to do it, but I found myself doing quite a lot 
of manual editing of the resulting Word document, to make it reasonably 
formatted for a formal deliverable. In particular, I had to do the 
following (this is a partial list):
1. Saved the individual wiki pages in mht format (web archive, single 
file), which can be then edited in Word (and saved in native docx format)
2. Removed 'garbage' text related to wiki info etc
3. Copied all the files into a single file
4. Added standard FIWARE title page and 'preface' pages (executive 
summary, change history, etc), header/footer, etc
5. Removed individual Legal Notice sections, added a single Legal Notice 
section under the 'preface' section (we did standardize on a single legal 
notice for all GEs)
6. Created 1st level headings for "Introduction" (the main Cloud 
architecture page) and for each GE, specifying the GE name (rather than 
the cryptic wiki page name)
7. Removed individual TOCs of each page, created the overall TOC (leaving 
only 2 levels)
8. Updated *all* the headings and levels of sub-section titles to reflect 
the new hierarchy, as well as to add sections numbering
9. Fixed all figure sizes, added figure captions, added table of figures
10. Did overall editing of the deliverable

..and I am surely missing some steps I applied.

I am curious to know whether others are going through a similar process, 
and maybe even achieved similar results in an easier way? After all, it 
might be desirable to have consistent outcomes (and we are already few 
days late). FYI, attaching the current draft (several inconsistencies and 
various content issues still to be fixed). Any thoughts/comments are 
welcome.


Thanks,
Alex

====================================================================================
Alex Glikson
Manager, Cloud Infrastructure Solutions, IBM Haifa Research Lab
Email: glikson at il.ibm.com | Phone: +972-4-8281085 | Mobile: 
+972-54-6466667 | Fax: +972-4-8296112

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.fiware.org/private/fiware-chapter-architects/attachments/20150303/63e0504b/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Cloud Hosting Architecture R4 - All.docx
Type: application/octet-stream
Size: 931971 bytes
Desc: not available
URL: <https://lists.fiware.org/private/fiware-chapter-architects/attachments/20150303/63e0504b/attachment.obj>


More information about the Fiware-chapter-architects mailing list

You can get more information about our cookies and privacy policies clicking on the following links: Privacy policy   Cookies policy