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

Enrich README with explanation of AMPL code #31

Merged
merged 54 commits into from
Feb 29, 2024
Merged

Conversation

p-arvy
Copy link
Member

@p-arvy p-arvy commented Oct 18, 2023

Please check if the PR fulfills these requirements

  • The commit message follows our guidelines
  • Tests for the changes have been added (for bug fixes / features)
  • Docs have been added / updated (for bug fixes / features)

Does this PR already have an issue describing the problem?

What kind of change does this PR introduce?

Add user documentation of AMPL code in README

What is the current behavior?

No documentation is available (except some comments in AMPL code)

What is the new behavior (if this is a feature change)?

Does this PR introduce a breaking change or deprecate an API?

  • The Breaking Change or Deprecated label has been added
  • The migration guide has been updated in the github wiki (What changes might users need to make in their application due to this PR?)

Other information:

Signed-off-by: parvy <pierre.arvy@artelys.com>
@p-arvy p-arvy requested review from klorel and annetill October 18, 2023 14:48
@p-arvy p-arvy self-assigned this Oct 18, 2023
@sonarqubecloud
Copy link

Kudos, SonarCloud Quality Gate passed!    Quality Gate passed

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
open-reac/README.md Outdated Show resolved Hide resolved
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
@p-arvy p-arvy changed the title [WIP] Enrich README with explanation of AMPL code Enrich README with explanation of AMPL code Feb 26, 2024
@p-arvy p-arvy requested review from So-Fras and klorel February 26, 2024 17:29
Copy link
Member

@So-Fras So-Fras left a comment

Choose a reason for hiding this comment

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

Thanks for the huge amount of documentation work done here. I left minor comments.

Regarding Artelys advertisement about selling keys, is it appropriate to include it in here though? I am not sure of our policy on that matter but it startled me a little :)

open-reac/README.md Outdated Show resolved Hide resolved
are free to configure a different one.

If you chose to run Knitro, you must have `knitroampl` in your path, after the installation
of the solver is done and that you got a valid licence. To check, start a bash and run:
```bash
knitroampl stub
Copy link
Member

Choose a reason for hiding this comment

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

What is this command line suppose to produce? What I've got is the following:

##### This license is only [...]. #####
##### License is valid until [...] #####
knitroampl: can't open stub.nl

It would be nice to give the output so that a beginner may know what to expect.

Copy link
Member Author

Choose a reason for hiding this comment

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

This comment, as well as those indicating that Artelys sells keys for AMPL and Knitro were already in the README and come from this commit #1 .

I also get this result running the command. Despite the error, this indicates that the knitroampl command is recognised. But it could be confusing for the user indeed.

I propose to remove these comments. What do you think @So-Fras ?

open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Show resolved Hide resolved
open-reac/README.md Outdated Show resolved Hide resolved
open-reac/README.md Show resolved Hide resolved
Signed-off-by: parvy <pierre.arvy@artelys.com>
Signed-off-by: parvy <pierre.arvy@artelys.com>
Copy link

Quality Gate Passed Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

@So-Fras So-Fras merged commit 18424ae into main Feb 29, 2024
6 checks passed
@So-Fras So-Fras deleted the enrich_readme_comments branch February 29, 2024 10:32
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