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

First documentation pages #346

Open
1 of 7 tasks
Tracked by #348
hartig opened this issue Jul 11, 2024 · 4 comments · May be fixed by #355
Open
1 of 7 tasks
Tracked by #348

First documentation pages #346

hartig opened this issue Jul 11, 2024 · 4 comments · May be fixed by #355

Comments

@hartig
Copy link
Member

hartig commented Jul 11, 2024

As a first set of documentation pages for potential users of HeFQUIN (users != developers who want to work on HeFQUIN itself), we need the following pages.

  • How to start the Web service via Docker, change the federation description that it uses, and how to issue queries to the service.
  • How to start the Web service from the latest release package, change the federation description that it uses, and how to issue queries to the service.
  • How to run queries using the CLI tool in the latest release package, including a detailed description of the arguments of the CLI tool.
  • How to run queries using the latest source code version of the CLI tool or the Web service.
  • How to specify the federation to be queried, including a documentation of the most important parts of the RDF vocabulary defined for this purpose.
  • Additionally, we need to create a README.txt file that we put in the top-level directory of the release packages and that contains a short version of these points above, including pointers to the respective documentation pages.
  • A similar summary of these points needs to be added to the README.md of the repo.

/cc @keski

@hartig hartig mentioned this issue Jul 13, 2024
4 tasks
@keski
Copy link
Collaborator

keski commented Aug 22, 2024

I've added a first version of the usage summary to the README.md in the issue branch.

@hartig Is this on a good level of detail or did you have anything else in mind?

@keski
Copy link
Collaborator

keski commented Aug 22, 2024

For the detailed instructions I assume we will be using the wiki?

@hartig
Copy link
Member Author

hartig commented Aug 22, 2024

I've added a first version of the usage summary to the README.md in the issue branch.

Which branch exactly? Is (or was) this in a PR?

For the detailed instructions I assume we will be using the wiki?

This question is related to one of the two proposals that I wanted you to work out (see my Malaga follow-up email).

@keski
Copy link
Collaborator

keski commented Aug 22, 2024

Okay, I viewed the two as separate issues but now I see your point. I'll respond by email.

The branch I referred to with updated README is 346-first-documentation-pages.

@hartig hartig linked a pull request Aug 23, 2024 that will close this issue
@hartig hartig linked a pull request Aug 23, 2024 that will close this issue
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 a pull request may close this issue.

2 participants