Following discussions with users it was agreed that we could modify the user guide to illustrate that Iris 'cubes' are not always of a 'standard' form (e.g. time, height, latitude, longitude).

A possible example would be the use of polar coordinates and elevation from radar. Perhaps we could find a way of illustrating the contents of this non-rectangular 'cube' along with a gallery example.

At the very least, let's use a branch - one for source, the other for build.

http://scitools.org.uk/pages/about.html

Problems with this page:

• empty contributors list
• only linked to from the governance page
• it's own "about" link goes to github

If you click on the "Visualisation exmples" link here...
http://scitools.org.uk/iris/docs/latest/examples/index.html

...it takes you to Iris 1.1! 😟

http://scitools.org.uk/drupal

http://scitools.org.uk/mailman/listinfo

should both be removed and installed as we have a google group instead https://groups.google.com/forum/?fromgroups#!forum/scitools-iris and https://groups.google.com/forum/?fromgroups#!forum/scitools-iris-dev.

From @lbdreyer, turns out that between rebasing and merging, there were some really useful comments in #182 (comment) that I missed.

Need to integrate these comments as a separate PR.

Not all Iris pages have a link to the governance page http://scitools.org.uk/pages/governance.html.

The Iris download page does have a link.
The Iris community page has a broken link.

remove the word 'the' from Crown copyright statement in the footer

"print iris.load" shows some fields as "unknown"

For example, with this GRIB2 file : http://bv.waihee.org/gfs.2015010800/gfs.t00z.pgrbf0-96-3.2p5deg.grib2 , doing "print iris.load" shows one field as "unknown", but when I convert that file to NetCDF (using "wgrib2") : http://bv.waihee.org/gfs.2015010800/gfs.t00z.pgrbf0-96-3.2p5deg.nc ) and do "print iris.load" on it, then the field shows up as "Precipitation Rate / (kg/m^2/s)" . I suspect this is because wgrib2 is reading "nameECMF" (or "name") field, whereas "iris.load" is reading "cfNameECMF" (or "cfName").

Another example : this GRIB1 file : http://bv.waihee.org/gfs.2015010800/gfs20150108081701674.grb . Three fields show up as "unknown" . grib_dump shows them as "Mean sea level pressure", "Precipitation rate" and "Geopotential Height" (strangely, cfNameECMF = geopotential_height, so iris.load is apparently not using the "cfNameECMF" field). FYI, I got this GRIB1 file from "http://saildocs.com", which is a GRIB email service used by sailors over slow data connections.

Thanks,
Ken

The iris home page http://scitools.org.uk/iris/index.html has a back-tick as the first character in the source which renders in the top left of the screen. This should be removed. I confused it for a speck of dirt on my screen!

Simple, clean and accessible, good stuff!

Might be worth mentioning, on the home page, that the list of formats is extensible.

Also might be worth, on the governance page:

• Turning the cla text into a link,
  as it might put people off, not bothering to find out for themselves.
• Mentioning that the benevolent dictator model is intended to end (if it still is).
• The mention of "TIS" won't mean anything to people. Perhaps "IT" or "TIS (IT)"?
• "We have listed below the available support channels for the project". Fibber!

Finally, on the code page, the table of contents seems silly on such a tiny page :D

Add web pages for cartopy to mirror the Iris web pages.

You may want to correct SciTools organistation on GitHub on https://scitools.org.uk/

I'd like to see the rendered list of contributors return to the scitools website. The README states that:

contributors.json contains a JSON dictionary of all contributors who have signed the scitools CLA. It is the definitive source (as rendered in scitools.org.uk/about.html)

This is no longer true, in that the about page is different and does not contain the rendered list of contributors.

This page was useful when a human wants to check why the CLA bot failed (sometimes the submitting user has signed the CLA but the commit isn't using a registered email) and provide feedback to users submitting PRs.

You may want to add an explicit link to the website related issues from http://scitools.org.uk/cartopy/docs/latest/index.html#getting-involved, possibly in Contribute to the documentation

It looks like there is a spurious html directory inside the iris 2.2.1 docs directory merged in #223, the content from that directory should be moved into the 2.2.1 directory (iris/docs/v2.2.1/html/* -> iris/docs/v2.2.1/)

It doesn't build yet (SciTools/iris-grib#49),
but when it does it may be handy to have it here.
Like #133

On http://www.scitools.org.uk/iris/docs/latest/developers_guide/gitwash/git_resources.html the 'git cheat sheet' link returns a 404 error.

The website is currently updated by adding bits (i.e. uploading stuff),

• but this can leave obsolete stuff in place.

Have now removed all references to the obsolete /pages/ htmls

• see #61

But ideally, we do also need to purge out all the obsolete info.

Key aim : make the scitools website a simple image of the repo.

Add approved privacy policy for contributors to be informed on how personal data will be protected, access to it controlled and procedure for review and update.

The documentation clean up for the 1.1 branch removed the contributors section from the copyright page. Add all the people from that page who aren't already on http://scitools.org.uk/pages/about.html

The rationale given is "thus reducing the overall repository size to those that need to clone the repository", but one of the old taglines for git is it's the "stupid content tracker", key word being content. Having multiple copies of the same file does not substantially change the size to be cloned:

mkdir separate
git init separate
cd separate
mkdir a b c
# This is the largest file in the repo at ~7M:
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf a/
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf b/
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf c/
git add a b c
git commit -m 'Initialize'
git gc --aggressive
cd ../

mkdir symlinked
git init symlinked/
cd symlinked
mkdir a b c shared
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf a/
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf b/
cp ../cartopy/docs/v0.15/examples/wmts_time_00_00.pdf c/
../tools/symlink_common.py . --shared-dir shared
git add a/ b/ c/ shared/
git commit -m 'Initialize'
git gc --aggressive
cd ..

This gives:

$ du -hsc */.git
7.3M	separate/.git
7.3M	symlinked/.git

Symlinking might be useful to reduce checkout size though, so maybe that's what it should say?

This page should present details on about the team, both current and alumni.

There are a number of PRs pending a CLA before they can be merged. Can someone at the MO confirm receipt/acceptance of CLAs from:

@dopplershift
@jsignell
@MartinDix

Found while scanning for the 'real' changes in #36 that there is a lot of noise in the commits, as all the new source files for cartopy v0.5 are listed as changes. All that is actually change in cartopy itself -- i.e. it is managed in another repo, so it could be much tidier if we factored that stuff out.
What it needs is for this repo to contain a build process, which constructs the docs (for the various release versions) from tag-links into the iris + cartopy repos -- instead of having all those html pages here themselves.
At present, it seems it could get a bit messy. Plus, we will eventually get to store loads+loads of different docs pages in multiple versions here, so that will eventually get cumbersome.

cartopy/pages/community.html exists, presumably, by analysis with the Iris 'community' page.
https://github.com/SciTools/scitools.org.uk/blob/master/cartopy/pages/community.html
But it is currently blank, which seems a bit of a turnoff ?

https://github.com/SciTools/scitools.org.uk/blob/master/tools/symlink_common.py

Publish an Iris roadmap. Suggested place in the heirachy would be under documentation.

Where is the source of the CLA assistant? And who's running it? The status that is posted on GitHub points to http://scitools.org.uk/governance.html#contributors, but that is an old link, and there are no contributors listed on the one it redirects to.

Where is the canonical list of contributors? Who should I ping to update it?

For example, I see in SciTools/iris#3299 that the bot thinks that bouweandela signed the CLA, but I can't find that name in contributors.json.

Logo to be added to all pages.

Should Biggus documentation not be on the website as well?

Content for the page needs to written to point to current documentation for the stable release along with pointers to historic releases. Documentation for 0.9 and 1.0 releases will need to be uploaded to the website.

a couple of URL's had erroneous information in them.

http://www.scitools.org.uk/cartopy/download.html :

These releases contain source, documentation and instructions
on how to build and install Iris under Linux.

It should say Cartopy.

Content will need to be written for the community page. This will need to include directions to the mailing lists and stackoverflow.

If you follow the cf-units link from the SciTools home page, you get docs for an old version, hosted on same site. The latest cf-units docs are at readthedocs.

Once the data proetction act issues have been resolved, publish a CLA along with fair processing notice so that potential contributors can give their permission for distribution of source code, documentation and any bug fixes.

The gallery has an incorrect image for the Colouring anomaly data with logarithmic scaling example, and a missing/broken image for Example of a polar stereographic plot.

Add detail to the About page and include a link to the blog

Not really an "issue", but I'm hoping that someone can make a quick cartopy script to display wind barbs from a GFS file.

For example, I wrote a little bash/curl script to get surface pressure, wind speed, prate, etc. Here is a resulting data file (converted to NetCDF w/ wgrib2) with all the forecasts concatenated together : http://bv.waihee.org/gfs.2015010800/gfs.t00z.pgrbf0-96-3.2p5deg.nc .

If someone could write a simple cartopy qplot script with wind barbs, I'd appreciate it.

Is it possible to make one plot with a contour lines for PRMSL, barbs for U/VGRD and contourf for the PRATE ?

Cheers,
Ken

The menu button (3-bars that replace right hand side navbar items) that appears in the mobile view doesn't do anything when you click on it. It should display a menu pop-up with the navbar options (Home, Organisation, Documentation, Github). You can reproduce in Chrome by navigating to https://scitools.org.uk and using the developer tools to simulate Pixel 2 (although any mobile setting I tried including iPad shows the same issue).

There is also a warning in the console: Failed to load resource: net::ERR_NAME_NOT_RESOLVED count.json:1. I don't know what this relates to or if it is important.

The site could have a custom 404 page, with the same styling as the site, at present it defaults to the host's 404, which looks/feels quite different.

It just feels a bit clunky, it's not a major issue.

Scitools contains 'code' detail pages for both iris + cartopy ...

• cartopy page, from source
• iris page, from source

At present, both these contain a redundant TOC which does basically nothing (because the page is so short, clicking takes you nowhere different).
It actually looks (IMHO) like it is presenting you a list of three useful activity links (cos it's not immediately obvious it's a TOC). But they go nowhere!

Probably just remove?

Create and upload a favicon for Cartopy pages. Favicon needs to be based on Cartopy logo but without the word 'Cartopy' on it.

Having moved the content, the symlinks are now invalid at https://github.com/SciTools/scitools.org.uk/tree/master/cf_units/docs/v1.1/_static. This is preventing the docs from being deployed.

We simply need to replace the symlinks with the correct location.

Add the following paragraph:

"Iris and Cartopy are open source Python libraries created by the Met Office to enable the visualisation of weather and climate data. Both libraries are actively developed in collaboration within the scientific community."

Privacy policy page to be updated with Department of BIS registration number.

remove usernames from the source, such as this.

I think these text files might just be intermediate build files.
If so we could add them to .gitignore.

Content for the download page will need to be written to direct the user to scitools/iris tags page.