doc: add a guide on getting started using configuration files

[johanehnberg]

WIP tasks

• Set the file location and if in root add a link in README or in doc add it to the ToC accordingly
• Augment the guide with something common and simple yet descriptive. For example defining a one-liner command in the config that runs on target to install camera/AP/sensor. Settled on SSH and wifi.
• Fix code snippet definitions sh->yaml for yaml files
• Test everything before removing WIP

Ideas for minimizing caveats and guide length outside the scope of this PR:

• Turn off PMAP for rpi3 and older
• Add layers for rpi1 rpi2 rpi0
• Move cross-build environment installs to install_deps.sh
• Add raspberrypi.gpg.key to keydir instead
• Feature request: Add a generic customization layer or allow custom commands in config #208
• Flatten and sort customization scripts in /bdebstrap before running them #210

Closes: #206

[learmj]

Hi @johanehnberg Let's just keep it all in one 'getting started' doc. Myself and others plus external / community will review it when it has content.

[johanehnberg]

@learmj OK. If the general structure of the document sits well with the project, all I need is a good, common case to use in the example. Preferably something that helps people install their own app/assets/file and run a command, but the working example only needing one such line each.

[learmj]

@learmj OK. If the general structure of the document sits well with the project, all I need is a good, common case to use in the example. Preferably something that helps people install their own app/assets/file and run a command, but the working example only needing one such line each.

Sounds good. If you're basing it on your own use / experience, that would serve others well.

[johanehnberg]

I added wifi station config as the simplest use case that we also have. It seems to have been requested so this may work as a stop-gap solution at least until a layer may be created. Considering the simplicity, I created #208 to allow streamlining much of this.

[johanehnberg]

Ready for review. The guide is a bit longer than what I aimed for, but as the tool matures and built-in layers get added, it can be shortened. The contents are now such that would have saved me a lot of hours when I started.

[jaysephjw]

Stumbled across this as I was looking at the project for the first time - and found it quite helpful!

Just a couple comments as I tried it.

[jaysephjw]

had to populate bdebstrap first

[johanehnberg]

The second echo should do that as it is, but let me know if something else related was needed?

[learmj]

Hi @stu-spp @martinn-ronin
As users who have previously indicated a preference for some intro documentation, how does this look to you?

Hi @johanehnberg I'd prefer to wait on getting some user / community feedback before merging. Thanks again for your efforts.

[johanehnberg]

Thanks @jaysephjw for the feedback! All fixed.

[stu-spp]

This looks great! ❤️