the "how" section should point to the BoS and the whitepapers

[attila-lendvai]

...and only after that should it list the various clients and installation artifacts.

well, at least IMO.

background: i talked to someone who recently looked into swarm, and he had no clue that there's a few pages long whitepaper that describes it from a bird's eye view perspective. (he knew about the BoS, but that may have originated from prior to looking at the site).