Make sudo changes optional

Due to the changes in crrev.com/c/36618, disabling tty_tickets is no
longer required to run cros_sdk. Making sudo more permissive can still
be helpful for workflows outside the chroot though, so change the sudo
instructions to make them optional.

BUG=None
TEST=Verify that `sudo grep -r tty_ticket /etc` has no results
TEST=cros_sdk works

Change-Id: Ieb67990a8dce0f2cf24683f2a4983899e4539bf8
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/docs/+/3611023
Auto-Submit: Nicholas Bishop <nicholasbishop@google.com>
Commit-Queue: Nicholas Bishop <nicholasbishop@google.com>
Tested-by: Nicholas Bishop <nicholasbishop@google.com>
Reviewed-by: Mike Frysinger <vapier@chromium.org>
2 files changed
tree: 2772a012182f23b4685aaf1856b5950368f938c2
  1. constants/
  2. design_docs/
  3. firmware/
  4. images/
  5. manatee/
  6. packages/
  7. portage/
  8. scripts/
  9. security/
  10. styleguide/
  11. testing/
  12. .gitignore
  13. adding_builder_variants.md
  14. archive_mirrors.md
  15. breakages_and_flakes.md
  16. ca_certs.md
  17. chrome_commit_pipeline.md
  18. chromeos_gn.md
  19. chroot-clangd-guide.md
  20. contact.md
  21. containers_and_vms.md
  22. contributing.md
  23. cros_commit_pipeline.md
  24. cros_deploy.md
  25. cros_flash.md
  26. cros_tools.md
  27. cros_vm.md
  28. crostini_developer_guide.md
  29. dbus_best_practices.md
  30. dbus_in_chrome.md
  31. debug_buttons.md
  32. developer_guide.md
  33. developer_mode.md
  34. development_basics.md
  35. disk_format.md
  36. eol_aue_process.md
  37. firmware_code_reviews.md
  38. firmware_test_manual.md
  39. firmware_ui.md
  40. git_and_gerrit_intro.md
  41. glossary.md
  42. gsutil.md
  43. input_stack.md
  44. kernel_development.md
  45. kernel_faq.md
  46. kernel_scheduler.md
  47. kernel_tips_and_tricks.md
  48. large_scale_changes.md
  49. life_of_a_bug.md
  50. logging.md
  51. lsb-release.md
  52. lsc_workflow.md
  53. navbar.md
  54. os_config.md
  55. OWNERS
  56. pd_firmware_update.md
  57. platform2_primer.md
  58. platform_public_tracker.md
  59. PRESUBMIT.cfg
  60. PRESUBMIT.sh
  61. README.md
  62. releases.md
  63. remote_trybots.md
  64. repo-tool.md
  65. reporting_bugs.md
  66. rust_on_cros.md
  67. sandboxing.md
  68. security_review_howto.md
  69. security_severity_guidelines.md
  70. simple_chrome_workflow.md
  71. source_layout.md
  72. stack_traces.md
  73. test_install_configuration.md
  74. tips-and-tricks.md
  75. unblocked_terms.txt
  76. work_on_branch.md
  77. write_protection.md
  78. xbuddy.md
README.md

ChromiumOS docs

This directory contains public ChromiumOS project documentation that is automatically rendered by Gitiles. The docs are written in Gitiles-flavored Markdown.

General guidelines

See the Chromium documentation guidelines and Chromium documentation best practices.

Style guide

Markdown documents must follow the style guide.

Making changes

This repository is managed by the repo tool, so you can make changes to it using the same techniques that you'd use for any other repositories in the project.

See the Contributing guide for more details.

Previewing changes

You can preview your local changes using scripts/preview_docs which utilizes Gerrit sandbox branches:

scripts/preview_docs README.md

You can also use md_browser, which is entirely local and does not require refs/sandbox/ push permission, but has somewhat inaccurate rendering:

# at top of ChromiumOS checkout
./src/chromium/src/tools/md_browser/md_browser.py -d docs

Then browse to e.g. http://localhost:8080/README.md.

To review someone else's changes, apply them locally first, or just click the gitiles link near the top of a Gerrit file diff page.