New issue
Advanced search Search tips

Issue 658752 link

Starred by 1 user

Issue metadata

Status: Archived
Owner:
Closed: Jan 2017
Components:
EstimatedDays: ----
NextAction: ----
OS: Chrome
Pri: 3
Type: Bug



Sign in to add a comment

Factory: Usage Guides in source repository as Markdown

Project Member Reported by hungte@chromium.org, Oct 24 2016

Issue description

Currently we have migrated the README files in factory repo into README.md, but we didn't explicitly specify what should be contained in README.md.

To help external developers understand how the factory software works, we should publish how-to and usage guides in a better way. A proposal is to make sure usage guide for all major components (i.e., instalog, dome, goofy, init, test_list, ... etc) are available in the source tree, as Markdown documents. This would help external developers to easily access the documents (for example, https://chromium.googlesource.com/chromiumos/platform/factory/+/master/README.md ) without worrying about if the given docs (from partner-site, or some pdf) is out-dated, also helps us to prevent maintaining lots of legacy usage guides.
 
Project Member

Comment 1 by bugdroid1@chromium.org, Oct 27 2016

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/310c63cc5c17c1b2b964518067d498c71f489d2f

commit 310c63cc5c17c1b2b964518067d498c71f489d2f
Author: Wei-Ning Huang <wnhuang@google.com>
Date: Thu Oct 27 05:20:29 2016

overlord: add deployment guide as README.md

Add overlord deployment guide as a README file.

BUG= chromium:658752 
TEST=none

Change-Id: Id002a90439c7717c5b929e8b1219a03a5168790c
Reviewed-on: https://chromium-review.googlesource.com/404188
Commit-Ready: Wei-Ning Huang <wnhuang@chromium.org>
Tested-by: Wei-Ning Huang <wnhuang@chromium.org>
Reviewed-by: Hung-Te Lin <hungte@chromium.org>

[add] https://crrev.com/310c63cc5c17c1b2b964518067d498c71f489d2f/go/src/overlord/README.md

Created https://b.corp.google.com/issues/32493714 for Instalog.
Project Member

Comment 3 by bugdroid1@chromium.org, Nov 14 2016

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/a5e91f0cc8373522922f34449634afb0f4cf703d

commit a5e91f0cc8373522922f34449634afb0f4cf703d
Author: Mao Huang <littlecvr@chromium.org>
Date: Mon Nov 14 07:05:25 2016

vswr: add README.md

BUG= chromium:658752 
TEST=None

Change-Id: I98ea6d0d77cd3dd93c43f4183daa1baca54afe1d
Reviewed-on: https://chromium-review.googlesource.com/410922
Commit-Ready: Mao Huang <littlecvr@chromium.org>
Tested-by: Mao Huang <littlecvr@chromium.org>
Reviewed-by: Hung-Te Lin <hungte@chromium.org>

[add] https://crrev.com/a5e91f0cc8373522922f34449634afb0f4cf703d/py/test/pytests/vswr/README.md

Project Member

Comment 4 by bugdroid1@chromium.org, Dec 1 2016

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/82f73348ef1412315f8800848a829b4ad6073f4b

commit 82f73348ef1412315f8800848a829b4ad6073f4b
Author: Hung-Te Lin <hungte@chromium.org>
Date: Thu Dec 01 07:51:50 2016

README.md: Add more complete factory software intro.

Merged information from
http://dev.chromium.org/chromium-os/how-tos-and-troubleshooting/building-factory-test-images

BUG= chromium:658752 
TEST=none

Change-Id: Iefa1e21ce2ae7716452e686c971a662a1057e33e
Reviewed-on: https://chromium-review.googlesource.com/415768
Commit-Ready: Hung-Te Lin <hungte@chromium.org>
Tested-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-by: Wei-Han Chen <stimim@chromium.org>

[modify] https://crrev.com/82f73348ef1412315f8800848a829b4ad6073f4b/README.md

Project Member

Comment 5 by bugdroid1@chromium.org, Dec 1 2016

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/82f73348ef1412315f8800848a829b4ad6073f4b

commit 82f73348ef1412315f8800848a829b4ad6073f4b
Author: Hung-Te Lin <hungte@chromium.org>
Date: Thu Dec 01 07:51:50 2016

README.md: Add more complete factory software intro.

Merged information from
http://dev.chromium.org/chromium-os/how-tos-and-troubleshooting/building-factory-test-images

BUG= chromium:658752 
TEST=none

Change-Id: Iefa1e21ce2ae7716452e686c971a662a1057e33e
Reviewed-on: https://chromium-review.googlesource.com/415768
Commit-Ready: Hung-Te Lin <hungte@chromium.org>
Tested-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-by: Wei-Han Chen <stimim@chromium.org>

[modify] https://crrev.com/82f73348ef1412315f8800848a829b4ad6073f4b/README.md

Comment 6 by hungte@chromium.org, Jan 25 2017

Owner: hungte@chromium.org
Status: Fixed (was: Untriaged)
We've migrated few important ones. Close as fixed.

Comment 7 by dchan@google.com, Apr 17 2017

Labels: VerifyIn-59

Comment 8 by dchan@google.com, May 30 2017

Labels: VerifyIn-60
Project Member

Comment 9 by bugdroid1@chromium.org, Jun 8 2017

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/a9a17baf242461dec7a8965e6480eba59d64d52b

commit a9a17baf242461dec7a8965e6480eba59d64d52b
Author: Wei-Han Chen <stimim@google.com>
Date: Thu Jun 08 06:45:50 2017

factory: add netboot setup guide

BUG= chromium:658752 
TEST=None

Change-Id: I91d25dd594865e01a079e98c6ad18f6306af1c14
Reviewed-on: https://chromium-review.googlesource.com/515184
Commit-Ready: Wei-Han Chen <stimim@chromium.org>
Tested-by: Wei-Han Chen <stimim@chromium.org>
Reviewed-by: Hung-Te Lin <hungte@chromium.org>

[add] https://crrev.com/a9a17baf242461dec7a8965e6480eba59d64d52b/setup/NETBOOT.md
[modify] https://crrev.com/a9a17baf242461dec7a8965e6480eba59d64d52b/README.md

Project Member

Comment 10 by bugdroid1@chromium.org, Jul 7 2017

The following revision refers to this bug:
  https://chromium.googlesource.com/chromiumos/platform/factory/+/580f3a7a2e05bd5602838b39591a28e55845c36a

commit 580f3a7a2e05bd5602838b39591a28e55845c36a
Author: Hung-Te Lin <hungte@chromium.org>
Date: Fri Jul 07 09:40:04 2017

README: Provide more links and clean up.

Make top level clean (with a single README.md) and provide more links so
most important README.md files are referenced in the top level file.

BUG= chromium:658752 
TEST=None

Change-Id: I4a463d9db53d0ffd3adda64c9769b6a305d6d7e8
Reviewed-on: https://chromium-review.googlesource.com/562908
Commit-Ready: Hung-Te Lin <hungte@chromium.org>
Tested-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-by: Youcheng Syu <youcheng@chromium.org>

[rename] https://crrev.com/580f3a7a2e05bd5602838b39591a28e55845c36a/setup/BUNDLE.md
[add] https://crrev.com/580f3a7a2e05bd5602838b39591a28e55845c36a/devtools/README.md
[modify] https://crrev.com/580f3a7a2e05bd5602838b39591a28e55845c36a/README.md

Labels: VerifyIn-61

Comment 12 by dchan@chromium.org, Oct 14 2017

Status: Archived (was: Fixed)

Sign in to add a comment