Rich,
The originals of the CF Conventions document and some others are in the
repository "repository-cf".
The DocBook files there are used to generate the html and pdf files in
the cf-documents repository. The sources for the web site itself are
in the cf-convention.github.io repository. Matthew Harris (mostly) and
I have done some hand tweaking at several points because Jekyll
(github's markdown processor) and github's server have difficulties with
complicated documents. Automating and documenting this is on our to-do
list.
Frankly, it isn't always clear to me which repository to work on when
there is a problem. We recently had a problem with the html version of
chapter 9 (which has complicated tables). I looked at all three
repositories in order to get part-way towards a diagnosis the problem.
I don't know which ones Matthew worked on when he fixed the problem, but
I don't think he touched repository-cf.
- Jeff
On 4/17/14 7:47 AM, Signell, Richard wrote:
I might have missed it, but I still don't think my original question
has been answered:
So if we see a problem with pages on http://cf-convention.github.io/,
which github repo are we supposed to send a pull request to?
It's hard for me to tell which repo has the origin documents from
which all else is created.
Thanks,
Rich
On Wed, Apr 16, 2014 at 7:29 PM, Jeffrey F. Painter<[email protected]> wrote:
John,
Yes, the name cf-pcmdi.llnl.gov has been redirected to kitt.llnl.gov so that
cf-pcmdi.llnl.gov/trac is really the same as kitt.llnl.gov/trac. You can
tell because I just fixed your issue 4 on kitt, and now it's equally fixed
in both places.
The machine which was formerly cf-pcmdi.llnl.gov has very thoroughly died,
although we have all the data that was on it.
- Jeff
On 4/16/14 4:18 PM, John Graybeal wrote:
This was very helpful, thanks Jeff. I think it is complete with respect to
the concerns I raised.
A worry I had about the two trac sites was that peoople might update the
'wrong' one. But I see now they are the same content, so it is presumaby
just one site with some mapping under the hood to serve it two places. That
will work, so long as people know that's the deal.
Let us know when you are ready for attention on the CF Conventions
document, and what kind of work it needs.
John
On Apr 16, 2014, at 15:59, "Jeffrey F. Painter"<[email protected]> wrote:
Rebuilding the CF Conventions web site is one of several things we're
doing at PCMDI/LLNL to recover from a storm of hardware and software
failures.
Indeed the Trac system is up and you can get to it at
http://kitt.llnl.gov/trac. This is the official site in the sense that
contributions here will be preserved. But there's a reason why this url
hasn't been advertised. As we figure out how to reconfigure things, we
might decide to move the Trac system to another host. So please don't
bookmark that address. Instead, bookmark
http://cf-convention.github.io/
This is the home page of the CF Conventions web site. For the Trac
system, click on "CF Metadata Trac" in the "Quick Links" list.
In the near future the best url for the CF Conventions web site will be
http://cfconventions.org
but it doesn't redirect to the right address yet. Andrew Harwood is
trying to get that fixed, and has run into the kind of delays which are
familiar to any of us who work for large organizations.
Actually, the old url http://cf-pcmdi.llnl.gov is back up too. All that
one does is to give you an opportunity to "click here" to visit the github
site.
Back to Trac, your old login will still work if you had one. The old
system for getting an account there was to email me. That still works :-)
(Presently the other people who can add accounts are Tony Hoang, Renata
McCoy, and Karl Taylor). There never was much of anything in the Trac
system to tell you how to get an account, but there should be; I need to
figure it out.
And thanks, John, for pointing out #4. I'll fix it.
Now to the repositories and web site - There are three github
repositories which contain the pieces that go into the web site. I
relabeled them today in an attempt to make their purposes more clear. But
repositories by their very nature are not user-friendly. The most important
thing is that someone who only needs the web site will quickly realize that
he needs to be somewhere else. Matthew Harris and I will be working on it
some more.
But the web site isn't fundamentally very complicated. I can't see how
throwing a lot of manpower at it will make it work better or get things done
faster. In the future what would benefit from a few more contributors would
be the CF Conventions document itself, and its cousins. That is the
secondary reason, after the general principle of openness, why the CF
Conventions sources are on github now. BTW, the CF Conventions document is
written in DocBook. Earlier this year there was a brief discussion of
alternative formats. That belongs in a different thread, though.
Please let me know if I've neglected to respond to anything which needed
an answer from me.
- Jeff
On 4/16/14 11:50 AM, John Graybeal wrote:
Let me preface my concerns again volunteering to provide mildly
knowledgeable technical labor, if the issue is simply shortage of hours.
Problems with the new Trac site:
1) Apparently there was a transition where the new site
http://kitt.llnl.gov/trac/ is now the real site?
- If so, I missed that announcement, sorry (or if there wasn't one,
there needs to be one.)
- If not, we need to clarify what gets reported where 'in the
meantime'.
2)<resolved>
3) If the new site is the official site can we make it straightforward
and documented how people get accounts and recover passwords?
4) The upper left logo error (logo missing, not a crisis) sends you back
to the old Trac site (http://cf-pcmdi.llnl.gov/trac/). Be warned.
Suggestion re the process of reporting problems:
A) Rather than reporting all problems on one ticket, create a new ticket
for each problem and use the component 'cf-trac-site' or 'cf-web-site' as
appropriate. There are a large number of problems that result from reporting
multiple problems on one issue ticket.
I have some additional issues with the new site, including Rich's, but
perhaps best to resolve the above first.
John
On Apr 16, 2014, at 05:49, Nan Galbraith<[email protected]> wrote:
Hi Rich -
There's a trac ticket for problems with the new website:
http://kitt.llnl.gov/trac/ticket/111
For other types of problems, not related to the site itself, I'm not
sure.
Nan
On 4/16/14 7:47 AM, Signell, Richard wrote:
CF folks,
Moving to github should help the community contribute and be able to
fix problem with the CF documents. But I'm a little confused about
what to do if we see a problem at http://cf-convention.github.io/ and
we want to submit a pull request to change them.
At the CF github organization (https://github.com/cf-convention) I see
three repositories:
1. cf-convention.github.io
which controls the github pages showing up at
http://cf-convention.github.io/
2. cf-documents
which contains HTML and PDF versions of the documents
3. repository-cf
a git svn clone of the old PCMI SVN repository
So if we see a problem with pages on http://cf-convention.github.io/,
which repo are we supposed to send a pull request to?
Thanks,
Rich
--
*******************************************************
* Nan Galbraith Information Systems Specialist *
* Upper Ocean Processes Group Mail Stop 29 *
* Woods Hole Oceanographic Institution *
* Woods Hole, MA 02543 (508) 289-2444 *
*******************************************************
_______________________________________________
CF-metadata mailing list
[email protected]
http://mailman.cgd.ucar.edu/mailman/listinfo/cf-metadata
------------------------------------
John Graybeal
Marine Data Manager
M +1 408 675-5445
skype: graybealski
Marinexplore
920 Stewart Drive
Sunnyvale 94085
California, USA
www.marinexplore.com
_______________________________________________
CF-metadata mailing list
[email protected]
http://mailman.cgd.ucar.edu/mailman/listinfo/cf-metadata
_______________________________________________
CF-metadata mailing list
[email protected]
http://mailman.cgd.ucar.edu/mailman/listinfo/cf-metadata
------------------------------------
John Graybeal
Marine Data Manager
M +1 408 675-5445
skype: graybealski
Marinexplore
920 Stewart Drive
Sunnyvale 94085
California, USA
www.marinexplore.com
_______________________________________________
CF-metadata mailing list
[email protected]
http://mailman.cgd.ucar.edu/mailman/listinfo/cf-metadata
_______________________________________________
CF-metadata mailing list
[email protected]
http://mailman.cgd.ucar.edu/mailman/listinfo/cf-metadata
