Clear and Concise

The article highlights a shift in the approach in product documentation (particularly in smaller startups)  from commercial software like Microsoft Word and Adobe FrameMaker were the industry standards. The trend is now towards open-source alternatives like Apache OpenOffice and LibreOffice. View Publication

Modern web applicatiox (such as Google Docs) implement many coordinated user functions and tasks traditionally associated with desktop software (such as Microsoft Office).. Key topics include: • Open-Source Standards: The use of JavaScript, HTML5, and CSS. • MVC Architecture: Separation of concerns into Model, View, and Controller. • Single-Page Applications (SPA) enhance user experience without full page reloads. • Microapps: Breaking single-page applications into smaller, independent services. • Responsive Web Design: Ensuring web applications work on various devices. • Web Services: Using REST and SOAP for server-side communication. View publication

The impact on documentation is huge when project teams adopt agile practices to plan and deliver products and services. Key Takeaways: Agile Principles and Technical Documentation: Agile development prioritizes working software, collaboration, and adaptability, which significantly impacts technical documentation. Shift from Formal Specifications: In agile, writers must rely on working software, not formal specifications, to create documentation. Dynamic Documentation: Agile emphasizes creating documentation that is relevant, stable, and continuously updated based on feedback. Audience Analysis: Understanding the target audience is crucial for creating effective documentation. User Stories and Tasks: User stories and tasks provide a structured approach to breaking down documentation requirements. Continuous Delivery and Kanban: Agile's focus on continuous delivery and the use of kanban boards help ensure that documentation aligns with the evolving product. The article also inc...

Researched,, planned, and validated the RESTful web service concept, task and reference topics (including detailed code examples) that describe how application developers can implement and use the Access Control Service ( https://github.com/predix/acs ) for fine-grained authorization and access without having to add complex authorization logic to their industrial web applications that run on dedicated Predix services and data. View Publication

Researched, planned, and validated the RESTful web service concept, task and reference topics (including detailed code examples) to combine multiple microapps ( https://github.com/predix/apphub-microapp-seed ) into a unified interface with global navigation and a common mechanism for user authentication to their industrial web applications that run on dedicated Predix services and data. View Publication

Researched, planned, and created the conceptual, task, and reference topics for open-source user interface components ( https://github.com/predixdesignsystem ) that enable developers or designers  to quickly and easily create industrial web applications that run on dedicated Predix services and data. View Publication