Skip to content

GAIA: Astroquery documentation: general update [ci skip]#2969

Merged
bsipocz merged 8 commits into
astropy:mainfrom
esdc-esac-esa-int:ESA_gaia_update_documentation
Apr 6, 2024
Merged

GAIA: Astroquery documentation: general update [ci skip]#2969
bsipocz merged 8 commits into
astropy:mainfrom
esdc-esac-esa-int:ESA_gaia_update_documentation

Conversation

@cosmoJFH

Copy link
Copy Markdown
Contributor

We would like include some minor changes in the gaia documentation.



cc @esdc-esac-esa-int


Jira GAIAMNGT-1632

@bsipocz bsipocz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The RTD failures are unrelated, so this looks good pending a small very minor things.

In the meantime I noticed that most of the file has examples with skipped tests. Some of that makes sense (logins, uploaded tables, etc), but I think some could be included in testing, as a topic for a future PR (so the doctest-skip-all directive could be revised to ensure later parts are picked up for testing).

Comment thread docs/gaia/gaia.rst Outdated
Comment thread docs/gaia/gaia.rst
i.e.: *user_<your_login_name>.t<job_id>*)::

>>> full_qualified_table_name = 'user_<your_login_name>.t1539932994481O'
>>> full_qualified_table_name = 'user_<your_login_name>."t1710251325268O"'

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this looks weird, the "s are not in the table name in the narrative text in the line above

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This is required if the user wants to use a table name that contains capital letters. Otherwise, an error would be thrown. This is due to the TAP implementation at ESAC.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

My point is that the docs above says user_<your_login_name>.t<job_id>, without the quotation marks rather than user_<your_login_name>."t<job_id>", so which one is it? If the latter, then the narrative above needs to be changed, too

@cosmoJFH cosmoJFH Mar 18, 2024

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@bsipocz, I see now what you mean. I've updated the text including the text user_<your_login_name>."t<job_id>" as well as a small explanation.

Comment thread docs/gaia/gaia.rst
@codecov

codecov Bot commented Mar 18, 2024

Copy link
Copy Markdown

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 66.81%. Comparing base (b530378) to head (2b4281e).
Report is 4 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2969      +/-   ##
==========================================
+ Coverage   66.80%   66.81%   +0.01%     
==========================================
  Files         237      237              
  Lines       18321    18323       +2     
==========================================
+ Hits        12239    12243       +4     
+ Misses       6082     6080       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@bsipocz bsipocz left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks @cosmoJFH!

@bsipocz bsipocz merged commit 73afabf into astropy:main Apr 6, 2024
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.

2 participants