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

Update PDFgui user guide #167

Open
Tieqiong opened this issue Aug 19, 2024 · 3 comments
Open

Update PDFgui user guide #167

Tieqiong opened this issue Aug 19, 2024 · 3 comments

Comments

@Tieqiong
Copy link
Contributor

Tieqiong commented Aug 19, 2024

PDFgui user guide has not been updated since 2.0 release (May 2023). We might want this to be deployed along with the api document. There are also contents that need to be updated (e.g. things that related to setup.py which we replace with pyproject.toml).

The PDFgui user guide was made using texi2html 5.0 and deployed on https://www.diffpy.org/doc/pdfgui/index.html. This is also not aligned with the new deploy namespace (which it should be something like https://www.diffpy.org/pdfgui/...). Maybe we should change this and delete the older resource. Also remember to update all the links in the user guide.

@sbillinge I also found out that the new vs. old document namespace is happening in other packages too. For example we deployed the new diffpy.structure api on https://www.diffpy.org/diffpy.structure/, but using similar pattern from the above old pdfgui link I found the older api documents on https://www.diffpy.org/doc/structure/, which is showing 3.1.0 as the latest version (which should be 3.2.0 now). This might not be an issue if users follow readme, but it might be problematic in general because I see both when searching 'diffpy.structure api' on google.

@sbillinge
Copy link
Contributor

yes, I would like to get everything synchronized here and following the new approach, whatever that is.

@sbillinge sbillinge added this to the v3.1.0 milestone Aug 20, 2024
@Tieqiong
Copy link
Contributor Author

Things that need updates:

  1. package related info
    • release number and date
    • license information under Availability section (I'm not sure if PDFfit2 and PDFgui are under BSD license as mentioned in the manual)
    • update installation section to align with the cookiecutted style readme
    • update news (what is new section)
    • community (do we want diffpy-dev Google groups?)
  2. Content
    • figure 3.6 and 3.7 (The opened file is different from the file mentioned in the text)
    • API documentation link (used to be on danse.us site, see Replace DANSE links #186 )
    • all the texi2html related things and generating date. We might want to make changes on the texinfo files first and try using this tool to generate html.

@sbillinge please add anything that we might want to change.

@sbillinge
Copy link
Contributor

sbillinge commented Aug 26, 2024

Things that need updates:

  1. package related info

    • release number and date
    • license information under Availability section (I'm not sure if PDFfit2 and PDFgui are under BSD license as mentioned in the manual)

They are not, please refer tests to the actual license

  • update installation section to align with the cookiecutted style readme

Yes, good

  • update news (what is new section)

Yes

  • community (do we want diffpy-dev Google groups?)

No, put everything through dugout users or GitHub issues. I want to EOL dugout-dev. Maybe we can deprecate it?

  1. Content

    • figure 3.6 and 3.7 (The opened file is different from the file mentioned in the text)
    • API documentation link (used to be on danse.us site, see Replace DANSE links #186 )

Now it will be at GitHub.io. I want to deprecate docs at diffpy.org too.

  • all the texi2html related things and generating date. We might want to make changes on the texinfo files first and try using this tool to generate html.

Yes, not sure about this, let's discuss.

@sbillinge please add anything that we might want to change.

@sbillinge sbillinge removed this from the v3.1.0 milestone Sep 24, 2024
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

No branches or pull requests

2 participants