Reorganize repository for unified release

[glopesdev]

Adopt the standardised repository layout described in harp-tech/protocol#145, aligning this repository with the conventions shared by other Harp components and enabling a unified release of firmware, software, and documentation from a single CI pipeline.

Repository layout and build infrastructure

• Rename top-level folders to the agreed lowercase layout. The Firmware folder becomes firmware, Hardware becomes hardware, and Interface becomes software. A new docs/ folder is introduced as the root for repository documentation and assets.
• Add shared build infrastructure under software/build/, including Common.csproj.props, Common.csproj.targets, and Package.props, for consistent project metadata and packaging across software components.
• Extend the CI workflow with stages for building the firmware, software, and documentation, rendering workflow images, and publishing packages and documentation as part of a single release.

Self-contained documentation website

Add documentation scaffolding under docs/, including docfx.json, template, articles, images, and workflows. The shared harp-tech/docfx-tools repository is included as the docs/harp-docfx submodule. The site is built from the API metadata of the software components and published from the same CI pipeline that produces the firmware and software releases.

Cross-platform App packaging

Replace the platform-specific NSIS installer with a cross-platform dotnet tool package for the GUI App, installable on any platform with the .NET SDK and launchable as harp.behavior.

Notes

After merging, contributors will need to run git submodule update --init --recursive and dotnet tool restore when checking out the repository.

[banchan86]

It would be nice to also generate the register table for the API using harp.schemaprocessor, but right now it only lives on the harp-tech website repository and should probably be moved elsewhere if we want to invoke it. I raised a proposal to bundle it together with harp.toolkit harp-tech/toolkit#31.

Otherwise, the documentation portions of this PR look good to me!

[ChucklesOnGitHub]

Hi @glopesdev! @banchan86 and I are working on having the first few docs sites ready by end of September and are looking forward to having them served on harp-tech.org. I wanted to check what is the timeline for this repo reorganization so we can coordinate. The Sound Card and Timestamp Generator repos are also part of that first doc upload. Thanks for letting us know.

[glopesdev]

@ChucklesOnGitHub that sounds very much on target, with the release of the python interface we will be focusing on wrapping this next.