doc: Improve readability, remove migration stuff

nejraselimovic commented 2 years ago

Summary

Closes #488

Notes for Reviewers

You'll notice I deleted the whole /content/the-things-stack folder. I think we should completely remove it because December 1 is almost here and I assumed this PR won't get merged before that. The only useful info was about TTS features, so I kept and incorporated that as part of the Quick Start section. Everything else was about migration and will no longer be needed in a few days.

Taking this into account, I think there's no too many notes or bad links.

Checklist

[x] Scope: The referenced issue is addressed, there are no unrelated changes.
[x] Run Locally: Verified that the docs build using make server, posted screenshots, verified external links.
[x] Style Guidelines: Documentation obeys style guidelines in CONTRIBUTING.
[ ] Commits: Commit messages follow guidelines in CONTRIBUTING, there are no fixup commits left.

jpmeijers commented 2 years ago

The docs on using the migration tool is still useful for migrating from private V2 instances, Chirpstack instance, and usage of the migration tool in general. I refer back to this quite often for reasons other than migration. Recently I used it to move an end device from one application to another on the V3 stack.

nejraselimovic commented 2 years ago

The docs on using the migration tool is still useful for migrating from private V2 instances, Chirpstack instance, and usage of the migration tool in general. I refer back to this quite often for reasons other than migration. Recently I used it to move an end device from one application to another on the V3 stack.

We will keep all that documentation on https://www.thethingsindustries.com/docs/.

Some time ago we decided that ttn.org documentation should contain exclusively what's relevant for TTS Community Edition and TTN V2 public community network, so I think documentation about migration which will be applicable for private instances doesn't belong here. People who use private instances should read tti.com docs and follow instructions there. And for migrating devices from one app to another on the same instance - I don't recall that we mention that use case anywhere in our documentation (although we could), it's kind of a special case. We could add a link to tti.com migration tool docs and say "if you need to migrate devices from one app to another, check out this tool", but I don't think we need to have a whole section on ttn.org dedicated to migration just for that.

The migration content on this page was supposed to be just a shorter and simplified version on what we have on tti.com migration docs, so that community users could easily migrate from TTN V2 PCN to TTS Community Edition. For all other cases they should refer to tti.com migration docs.

@benolayinka please let us know what you think

jpmeijers commented 2 years ago

Yes, the tti.com docs address everything that I need, so I agree with you.

TheThingsNetwork / docs