|
1 | 1 | --- |
2 | 2 | layout: post |
3 | | -title: "Building Our Documentation Site on PlatformOS — Part 2: Content Production and Layouts" |
| 3 | +title: "Building Our Documentation Site on platformOS — Part 2: Content Production and Layouts" |
4 | 4 | excerpt: Welcome to part 2 of our article series where we discuss how content production started, and how we created the layouts and navigation for the site. |
5 | 5 | last_modified_at: Thu Nov 01 22:01:44 CDT 2018 |
6 | 6 | categories: articles |
7 | 7 | author: diana_lakatos |
8 | 8 | tags: [developer documentation, Content-First Design, community, style guide, templates, editorial workflow, wireframes, docs, documentation, UX] |
9 | 9 | image: |
10 | 10 | path: /images/platformos/platformos_part2/part2_cover.jpg |
11 | | - caption: "[Courtesy PlatformOS Blog](https://www.platform-os.com/blog/post/blog/building-our-documentation-site-on-platform-os-part-2-content-production-and-layouts)" |
| 11 | + caption: "[Courtesy platformOS Blog](https://www.platform-os.com/blog/post/blog/building-our-documentation-site-on-platform-os-part-2-content-production-and-layouts)" |
12 | 12 | comments: false |
13 | 13 | share: true |
14 | 14 | --- |
15 | 15 |
|
16 | | -Welcome to part 2 of our article series where we describe the process of building the [PlatformOS documentation site](https://documentation.platform-os.com/) from discovery to development, with in-depth insights into our approach, decisions, plans, and technical implementation. |
| 16 | +Welcome to part 2 of our article series where we describe the process of building the [platformOS documentation site](https://documentation.platform-os.com/) from discovery to development, with in-depth insights into our approach, decisions, plans, and technical implementation. |
17 | 17 |
|
18 | 18 | Now that you’ve seen how we explored the needs of our audience, outlined the types of content we’d work on, and created a sitemap in part 1, let’s move on to discuss how content production started, and how we created the layouts and navigation for the site. |
19 | 19 |
|
@@ -136,12 +136,12 @@ _Wireframe for the tutorial topic type_ |
136 | 136 |
|
137 | 137 | As you can see from the process so far, we put our focus on audience, content, and UX — leaving visual design for later. |
138 | 138 |
|
139 | | -Both the Design Thinking approach, and the Content-First approach we described in this article push visual design to a later stage. At the same time, the branding of PlatformOS is still in the making — with the help of the wonderful [Yiying Lu](https://www.linkedin.com/in/yiyinglu/). This means, that by the time our branding is done, we will have a working documentation site tested with real users, continuously improved based on relevant feedback. We believe that this way we could focus on the most important aspects for each phase, and our documentation site will have a solid foundation that the design can enhance. This is why, for now, we went with a very simple, clean design. |
| 139 | +Both the Design Thinking approach, and the Content-First approach we described in this article push visual design to a later stage. At the same time, the branding of platformOS is still in the making — with the help of the wonderful [Yiying Lu](https://www.linkedin.com/in/yiyinglu/). This means, that by the time our branding is done, we will have a working documentation site tested with real users, continuously improved based on relevant feedback. We believe that this way we could focus on the most important aspects for each phase, and our documentation site will have a solid foundation that the design can enhance. This is why, for now, we went with a very simple, clean design. |
140 | 140 |
|
141 | 141 | We hope you enjoyed learning about how we started content production, how we built our editorial workflow, and how we created wireframes for our documentation site. **Stay tuned to learn more about the community aspects of our docs in part 3 of our series!** |
142 | 142 |
|
143 | 143 | _We involved [UX Strategist Katalin Nagygyörgy](https://www.linkedin.com/in/nagygyorgykatalin/) in our process from the start. Through our collaboration, we could extract and collect all the necessary information using tried and true research methodologies and UX best practices._ |
144 | 144 |
|
145 | | -_This article was originally written for the [PlatformOS Blog](https://www.platform-os.com/blog/post/blog/building-our-documentation-site-on-platformos-part-2-content-production-and-layouts)._ |
| 145 | +_This article was originally written for the [platformOS Blog](https://www.platform-os.com/blog/post/blog/building-our-documentation-site-on-platformos-part-2-content-production-and-layouts)._ |
146 | 146 |
|
147 | 147 | {% include sign-up.html %} |
0 commit comments