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

Docs/SK-924 | Update quickstart guide #648

Merged
merged 15 commits into from
Jul 10, 2024
Merged

Docs/SK-924 | Update quickstart guide #648

merged 15 commits into from
Jul 10, 2024

Conversation

ahellander
Copy link
Member

@ahellander ahellander commented Jul 1, 2024

Description

https://fedn.readthedocs.io/en/docs-sk-924/quickstart.html

Starts implementing the Docs updates we discussed:

  • Reorganize main menu
  • Remove local dev instructions and Docker from git-repo examples
  • Collect local dev instructions in a developer guide

Copy link
Contributor

@niklastheman niklastheman left a comment

Choose a reason for hiding this comment

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

I have some thoughts:

  • I think the "Getting started with FEDn" section should be under "Introduction".
  • I think using the Studio interface should be present in the "Getting started with FEDn" guide. Then, of course we can include a short line on how to achieve the same result using the cli.
  • Running the client in the "Getting started with FEDn" example is still done via docker.
  • I would prefer if the "Getting started with FEDn" guide did not make use of the mnist-pytorch example but instead took the reader through creating their own FEDn project. (perhaps could be done later)

Copy link
Contributor

@niklastheman niklastheman left a comment

Choose a reason for hiding this comment

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

I think this is an improvement!

A suggestion for the later is to use tabs to display how to do things using the UI or APIClient. This is of course not for now...


.. code:: python

>>> ...
>>> client.download_model("<model-id>", path="model.npz")


**Connecting clients using Docker**
Connecting clients using Docker
Copy link
Contributor

Choose a reason for hiding this comment

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

Are we sure this is needed in the "Getting started" section?

Copy link
Member Author

Choose a reason for hiding this comment

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

Fixed.

docs/quickstart.rst Outdated Show resolved Hide resolved
docs/quickstart.rst Show resolved Hide resolved
docs/quickstart.rst Show resolved Hide resolved
docs/quickstart.rst Show resolved Hide resolved

git clone https://github.com/scaleoutsystems/fedn.git

Locate into ``examples/mnist-pytorch`` folder. The compute package is located in the folder ``client``.
Copy link
Member

Choose a reason for hiding this comment

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

should be "fedn/examples/mnist-pytorch"

Copy link
Member Author

Choose a reason for hiding this comment

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

Fixed.

@ahellander ahellander changed the title Docs/sk 924 Docs/SK-924 Jul 9, 2024
@ahellander ahellander changed the title Docs/SK-924 Docs/SK-924 | Update quickstart guide Jul 10, 2024
@ahellander ahellander requested a review from Wrede July 10, 2024 07:57
@ahellander ahellander merged commit c47a636 into master Jul 10, 2024
19 checks passed
@ahellander ahellander deleted the docs/SK-924 branch July 10, 2024 09:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants