Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added getting started to documentation #5500

Merged
merged 6 commits into from
Jan 12, 2022
Merged

Added getting started to documentation #5500

merged 6 commits into from
Jan 12, 2022

Conversation

eaba
Copy link
Contributor

@eaba eaba commented Jan 12, 2022

  • Created getting-started sub-directory
  • Created Tutorial Overview
  • Moved all the Tutorials into getting-started sub-directory of intro

Part fix for #5483

Changes

Moved all the tutorials under introduction to it own section

Checklist

For significant changes, please ensure that the following have been completed (delete if not relevant):

* Created Tutorial Overview
* Moved all the Tutorials into getting-started sub-directory of intro
* **<a href="../getting-started/tutorial-1.html">Part 1: Top-level Architecture</a>**
* **<a href="../getting-started/tutorial-2.html">Part 2. The Device Actor</a>**
* **<a href="../getting-started/tutorial-3.html">Part 3. Device Groups and Manager</a>**
* **<a href="../getting-started/tutorial-4.html">Part 4. Querying a Group of Devices</a>**
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The purpose of this is to provide an over view on the nature of the application the tutorial was about. I gave a link to the various parts at the bottom.

<body>
<p>This page has been moved to <a href="../intro/getting-started/tutorial-1.html">Part 1. Top-level Architecture</a>.</p>
</body>
</html>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For this and the rest, this is for backward compatibility.

- name: Use-case and Deployment Scenarios
href: intro/use-case-and-deployment-scenarios.md
- name: Production Users and Use Cases for Akka.NET
href: intro/akka-users.md
- name: Getting Started
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To put all tutorials under this section

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, so rather than have one giant toc.yml here we should probably have each folder use its own toc.yml and then just reference that from the main articles/toc.yml - we need to add this as part of our DocFx Hygiene Guidelines

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it

src/common.props Show resolved Hide resolved
src/common.props Show resolved Hide resolved
Copy link
Member

@Aaronontheweb Aaronontheweb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just need to make one change to toc.yml, but otherwise this looks good.

Have you tested your changes locally in DocFx to ensure that they work? @eaba

- name: Use-case and Deployment Scenarios
href: intro/use-case-and-deployment-scenarios.md
- name: Production Users and Use Cases for Akka.NET
href: intro/akka-users.md
- name: Getting Started
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, so rather than have one giant toc.yml here we should probably have each folder use its own toc.yml and then just reference that from the main articles/toc.yml - we need to add this as part of our DocFx Hygiene Guidelines

@eaba
Copy link
Contributor Author

eaba commented Jan 12, 2022

Just need to make one change to toc.yml, but otherwise this looks good.

Have you tested your changes locally in DocFx to ensure that they work? @eaba

Yes, tested locally. That helped me a lot in understanding what I was doing!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants