I notice the first few merged PRs have been about updating documentation. Is it necessary for every new API to have include both documentation comments and a markdown guide document?
Personally I find the Swift documentation comment format very readable on its own, and there is some value for those wishing to learn about algorithms by having it next to code.
Is there some other purpose for these guide documents? Could we maybe generate them from the documentation comments?