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

change local documentation link to diffpy.org #203

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Tieqiong
Copy link
Contributor

closes #172

Copy link
Contributor

@sbillinge sbillinge left a comment

Choose a reason for hiding this comment

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

please see inline

@@ -55,7 +55,7 @@
APPDATADIR = os.path.abspath(APPDATADIR)

# Location of the HTML manual
docMainFile = os.path.join(APPDATADIR, "doc/manual/pdfgui.html")
docMainFile = "https://www.diffpy.org/diffpy.pdfgui/manual.html"
Copy link
Contributor

Choose a reason for hiding this comment

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

please check, this doesn't look right to me. If it is user-facing I think it ishould be to a published docs url (somewhere on github.io), but if it is used by the code to find a path to do something, it should be somewhere in a local doc/build folder, something like that.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Refer to the discussion here: Billingegroup/cookiecutter#108, we probably not going to include doc in distribution. So the online url would be the way to go.

Yes I'll change all diffpy.org links to GitHub.io. One thing to make sure is how GitHub.io name its sub-pages and how it's mapping things to the current release in diffpy.org... Might need to do a solely doc "pre-release" sometime to make sure I'm not doing it wrong...

Copy link
Contributor

Choose a reason for hiding this comment

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

I think you should be able to do a local build. If we want to test a deploy just add push: main to the doc y'all. We can remove it again after the test.

@Tieqiong Tieqiong mentioned this pull request Aug 28, 2024
Copy link
Contributor

@sbillinge sbillinge left a comment

Choose a reason for hiding this comment

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

Please see inline

@@ -55,7 +55,7 @@
APPDATADIR = os.path.abspath(APPDATADIR)

# Location of the HTML manual
docMainFile = os.path.join(APPDATADIR, "doc/manual/pdfgui.html")
docMainFile = "https://www.diffpy.org/diffpy.pdfgui/manual.html"
Copy link
Contributor

Choose a reason for hiding this comment

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

I think you should be able to do a local build. If we want to test a deploy just add push: main to the doc y'all. We can remove it again after the test.

@bobleesj
Copy link
Contributor

@Tieqiong Hi Tieqiong, what's the status on this PR? Trying to close as much as we can

@bobleesj
Copy link
Contributor

bobleesj commented Oct 2, 2024

@Tieqiong seems to be closing one of the issues in the 3.1.0 milestone. Could you please share an update?

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.

Documentation in the help tab
3 participants