LAS16-506: The future of 96Boards documentation

The Future of 96Boards DocumentationRobert Wolff

ENGINEERS AND DEVICES

WORKING TOGETHER

Who am I?

● Robert Wolff

● Engineer - Technical Writer

● Team: 96Boards at Linaro

Twitter: @sdrobertw and @96Boards

IRC: sdrobertw

Email: [email protected]

Coursera - IoT Specialization for DragonBoard 410c

Github - 96Boards and Linaro documentation repositories

OpenHours - www.96Boards.org/OpenHours

Author: Robert Wolff - [email protected] (09/30/16)

http://www.96boards.org/OpenHours

mailto:[email protected]

ENGINEERS AND DEVICESWORKING TOGETHER

Outline - The Future of 96Boards Docs

● Current Documentation

● The Old Ways

● New Approach

● Document “Contribution Cycle”

● Rethinking the Cycle

● The Process




Current DocumentationWhat’s so special about any of it?




WORKING TOGETHER

Current Documentation - Types

● PDF○ User Guides

○ Hardware Manuals

○ “How to” Guides

○ More...

● Wiki○ 96Boards

○ Linaro

○ Board specific

● Github Documentation Repositories○ 96Boards

○ Linaro

○ Other...




Current Documentation - Initial thoughts?

● Scattered

● Repeated

● Out dated

● Inconsistent

● Lack of ownership

● Consolidate

● Remove (if possible)

● Maintain

● Build out / template

● Assign ownership




Current Documentation - Initial thoughts?

Organize

Structure

Set/Use Conventions




The Old WaysA current approach




The Old Ways - A good start...

● SoC programmer’s Technical Reference Manual - PDF

● Hardware User Manual - PDF

● Schematics - PDF

● Getting Started Guide - PDF

➢ What happens when users want more?

➢ What happens when something needs to be changed?




The Old Ways - New doc?

Create a document

Throw it anywhere on the Internet

Don’t tell anyone

Never updateAuthor: Robert Wolff - [email protected] (09/30/16)



The Old Ways - Change doc?

Make a new doc,

put it anywhere,

without telling anyone...




New ApproachHow much better can it be?




New Approach - Goals

● Reduce static documentation

● Increase dynamic documentation

● Allow Vendor contribution and ownership

● Encourage community contribution and ownership

● Reduce points of contact

➢ What happens when users want more?

➢ What happens when something needs to be changed?




Document “Contribution Cycle”The hours add up and cost everyone $$$




Document “Contribution Cycle”

Community

Static Document

Document Owner

Use

Report

Report Raw Document

Fix

New Version

Error

Upload

96Boards

Inform

Fix




Rethinking the CycleResource allocation with minimal points of contact




Rethinking the Cycle

Community

Dynamic Document

New Document

Use

Report

Fix

Error UploadFix New

Document96Boards





● Quick and easy document modifications

● Straightforward document creation

● Community driven

● 96Boards maintained

● Website rendered




WORKING TOGETHER


96Boards will:

● Buffer

● Share

● Contribute

● Expand

● Maintain

With help from:

● Linaro

● Vendors

● Manufacturers

● Community

● Anyone...




The ProcessWorkflow, tools, methods, execution




Consistency




WORKING TOGETHER

The Process - Tools

Welcome to 96Boards:

● Landing page with core material

● Core Material and Setup

● Templates and instructions

● Support and Community




WORKING TOGETHER

The Process - Tools

Github:

● Git for command line

● Using Markdown and reStructured

● Downloadable PDFs are welcome

● Hosting images

● Share all 96Boards generic docs




WORKING TOGETHER

In Conclusion

We aim to provide:

● Dynamic

● Streamlined

● Consistent

● Well Maintained

● Robust

Documents

Created and supported by:

● 96Boards

● Linaro

● Vendors

● Manufacturers

● Community




WORKING TOGETHER

Links

➢ www.96boards.org

➢ www.96boards.org/openhours

➢ www.github.com/96boards/documentation

➢ www.github.com/Linaro/documentation

➢ www.coursera.org

➢ www.Linaro.org


http://www.96boards.org

http://www.96boards.org

http://www.96boards.org/openhours

http://www.96boards.org/openhours

http://www.github.com/96boards/documentation

http://www.github.com/96boards/documentation

http://www.github.com/Linaro/documentation

http://www.github.com/Linaro/documentation

http://www.coursera.org

http://www.coursera.org

http://www.linaro.org



Thank You

#LAS16For further information: www.linaro.org

LAS16 keynotes and videos on: connect.linaro.org



Extra Slides


Useful Logos

Download Hi Res logos from here* to use on your slides

*http://link.linaro.org/logos

http://link.linaro.org/logos

http://link.linaro.org/logos


This Slide is for when Two Columns are Needed● You can use this for two columns of

bullets

● Or you can replace one column

with an image or diagram

● This could be a second column of

bullets

● Or it could be a table, image or

graphic


WORKING TOGETHER

Alternative Content Slide● If you have a more succinct message, use this slide

Date post:	12-Jan-2017
Category:	Technology
Upload:	linaro
View:	353 times
Download:	1 times

LAS16-506: The future of 96Boards documentation

Technology

RDK ports on 96Boards

Las16 309 - lua jit arm64 port - status

LAS16-203: Platform security architecture for embedded devices

LAS16-403 - GDB Linux Kernel Awareness

SFO15-100: 96Boards & The Course Upstream

The status quo and the future of 96Boardss3.amazonaws.com/connect.linaro.org/las16/Presentations...The status quo and the future of 96Boards Yang Zhang Director of 96Boards What’s

Introducing Poplar: First 96Boards TV Platform

LAS16-200: SCMI - System Management and Control Interface

Linaro Networking Group OFP+ODP: highlighting NGINX, OpenSSL …s3.amazonaws.com/connect.linaro.org/las16/Presentations/Thursday/LAS16... · Bill Fischofer Forrest Shi Josep Puigdemont

Year end 96boards 2016

LAS16-200K2: Corporate Open Source Fail – Sarah Sharp

LAS16-406: Android Widevine on OP-TEE

LAS16-201: ART JIT in Android N

BUD17-408: RDK on 96Boards

LAS16-TR05: Getting Started in LAVA v2

From 96Boards to the Cloud - events.static.linuxfound.org 96Boards to the...From 96Boards to the Cloud. Who is Linaro Linaro is a collaborative engineering organization ... IoT client

AOSP Mini-Conferences3.amazonaws.com/connect.linaro.org/las16/Presentations/Thursda… · EAS: A common topic at Connect LAS16-TR04: Using tracing to tune and optimize EAS LAS16-410:

LAS16-207: Bus scaling QoS