search

redhat-documentation / community-collaboration-guide

A Red Hat guide to assist enterprise projects in collaborating with upstream communities on documentation.
https://redhat-documentation.github.io/community-collaboration-guide/
Creative Commons Attribution Share Alike 4.0 International
17 stars 20 forks source link

Introduction to Building Content #71

Closed pwright closed 6 years ago

pwright commented 6 years ago

Note: there's a lot of overlap between building and publishing, should we consider merging these two chapters?

pmkovar commented 6 years ago

@finp I think Publishing should be focused on describing hosting services and how to upload built sources to them. From that perspective, it makes sense to keep those two chapters separate.

pwright commented 6 years ago

@pmkovar I agree that "Publishing" should focus on hosting/uploading, but that doesn't seem to be what the current content addresses. I'm suggesting moving the current content (asciibinder/travis) into "Building". If we have content that addresses hosting/uploading I've no problem with that being in a "Publishing" chapter.

pmkovar commented 6 years ago

@finp Travis+GH Pages is really about hosting and uploading (automatically). The asciibinder section talks about asciibinder package which is, well, a prerequisite to uploading to a hosting site.

pwright commented 6 years ago

@pmkovar Ok, got it. I think the distinction will become clearer as content is added, eg: