[Liwg-core] [cgd-cseg] CESM2.0 documentation and web pages

Bill Sacks sacks at ucar.edu
Wed Mar 8 09:00:42 MST 2017


Good point. I agree.

> On Mar 8, 2017, at 8:53 AM, Jeremy Fyke <garmeson.lanl at gmail.com <mailto:garmeson.lanl at gmail.com>> wrote:
> 
> Linking from a few-paragraph description of 'ice sheets in CESM' sounds great (I'm a big recent fan/user of ***.github.io <http://github.io/> pages).  
> 
> Regarding coupling descriptions: since we have good content within the coupling manuscript (even right now) - hopefully we can either point to this manuscript (instead of duplicating high-level descriptions of the coupling), or safely copy/paste from this manuscript to this page (while avoiding potential plagiarism and journal content reuse rules).  Ideally, I would see this online resource as a 'technical' counterpart to the published 'high-level-description' coupling manuscript.  As such it would be great to see them both evolve together.
> 
> On Wed, Mar 8, 2017 at 8:11 AM, Bill Sacks <sacks at ucar.edu <mailto:sacks at ucar.edu>> wrote:
> Both: This is for documenting land ice within CESM.
> 
> This email mainly refers to the main landing page – where I expect us to just have a couple of paragraphs of text. From here we'll link to the more extensive documentation. Mariana just converted our Word-based document to a new format that lends itself to auto-generated web-based documentation. See current draft here:
> 
> https://ncar.github.io/CISM/doc/build/html/users_guide/index.html <https://ncar.github.io/CISM/doc/build/html/users_guide/index.html>
> 
> Bill S
> 
>> On Mar 8, 2017, at 7:34 AM, Fyke, Jeremy Garmeson <fyke at lanl.gov <mailto:fyke at lanl.gov>> wrote:
>> 
>> Hey Bill - is this documentation for just CISM, or broader coupling/SMB stuff?
>> 
>> Jer
>> 
>> --
>> Jeremy G. Fyke
>> https://jeremyfyke.github.io/ <https://jeremyfyke.github.io/>
>> Twitter: JeremyFyke
>> Theoretical Division (T-3)
>> Los Alamos National Laboratory
>> 505-606-0025 <tel:(505)%20606-0025>
>> 
>> On Mar 7, 2017, at 7:23 PM, Bill Sacks <sacks at ucar.edu <mailto:sacks at ucar.edu>> wrote:
>> 
>>> Hi all,
>>> 
>>> The upcoming documentation for CISM in CESM2.0 will be here:
>>> 
>>> http://www.cesm.ucar.edu/models/cesm2.0/land-ice/ <http://www.cesm.ucar.edu/models/cesm2.0/land-ice/>
>>> 
>>> If you have any ideas for text / info that should appear on that main landing page, let me know and/or see the email below.
>>> 
>>> Bill S
>>> 
>>>> Begin forwarded message:
>>>> 
>>>> From: Alice Bertini <aliceb at ucar.edu <mailto:aliceb at ucar.edu>>
>>>> Subject: [cgd-cseg] CESM2.0 documentation and web pages
>>>> Date: March 6, 2017 at 3:22:33 PM MST
>>>> To: cgd-cseg <cgd-cseg at ucar.edu <mailto:cgd-cseg at ucar.edu>>
>>>> Cc: webhelp at cgd.ucar.edu <mailto:webhelp at cgd.ucar.edu>
>>>> 
>>>> Hi all,
>>>> 
>>>> The CESM2.0 HTML model pages are in active development and need your help.
>>>> 
>>>> As liaisons, please communicate with your respective WG members who will be contributing to the web content, the following information:
>>>> 
>>>> URL: http://www.cesm.ucar.edu/models/cesm2.0 <http://www.cesm.ucar.edu/models/cesm2.0>
>>>> 
>>>> Physical Directory on CGD machines:  /cesmweb/html/models/cesm2.0
>>>> 
>>>> The bulk of the content changes required by the working groups is in the gh-pages ReStructured Text user's guides and the component subdirs in /cesmweb/html/modesl/cesm2.0/:
>>>> 
>>>> atmosphere  - should include WACCM, CAM-Chem and link to stand-alone diag tools (AMWG)
>>>> land - should include land BGC and link to stand-alone diag tools (LMWG)
>>>> land-ice  - include link to stand-alone diag tools (LIWG)
>>>> ocean - should include ocn BGC and link to stand-alone diag tools (OMWG)
>>>> sea-ice - needs a link to stand-alone diag tools (PCWG)
>>>> river - includes RTM,Mosart needs a link to stand-alone diag tools as part of lnd diags(LMWG)
>>>> wave - (OMWG?)
>>>> 
>>>> Please review all links and references to previous versions of the models and only include
>>>> those that will run with CESM2.0.
>>>> 
>>>> *PLEASE* let Erika do any design layout work. She's worked really hard to make sure
>>>> the new CESM website is clean and scales nicely on all kinds of devices. If you'd like
>>>> images added to your pages or styles added, then it will be best to work with Erika by sending email to webhelp at cgd.ucar.edu <mailto:webhelp at cgd.ucar.edu>.
>>>> 
>>>> We're still working on the dynamic building of namelist documentation, compsets, grids 
>>>> and machines using the XML files as input so those will be coming soon. 
>>>> 
>>>> Here's some guidelines for adding content:
>>>> 
>>>> 1. Please try and follow these basic 8 rules for good web page design:
>>>> 
>>>> https://blog.hubspot.com/blog/tabid/6307/bid/30557/6-Guidelines-for-Exceptional-Website-Design-and-Usability.aspx#sm.000015uvuvfk2xdzdqx7lxkouq93o <https://blog.hubspot.com/blog/tabid/6307/bid/30557/6-Guidelines-for-Exceptional-Website-Design-and-Usability.aspx#sm.000015uvuvfk2xdzdqx7lxkouq93o>
>>>> 
>>>> 2. Please do NOT add in-line style to HTML elements. Talk to Erika first to see if styles
>>>> can be added to cascading style sheets for consistency. 
>>>> 
>>>> 3. Please be mindful of screen real-estate and making sure the most important information
>>>> sits "above the fold" (i.e. before the user has to start scrolling down the screen).
>>>> 
>>>> Let me know if you have any questions or need help working with the gh-pages rst or html.
>>>> 
>>>> Thanks,
>>>> Alice
>>>> 
>>>> 
>>>> -- 
>>>> Alice Bertini
>>>> NCAR - CSEG Software Engineer
>>>> 
>>>> -- 
>>>> You received this message because you are subscribed to the Google Groups "cgd-cseg" group.
>>>> To unsubscribe from this group and stop receiving emails from it, send an email to cgd-cseg+unsubscribe at ucar.edu <mailto:cgd-cseg%2Bunsubscribe at ucar.edu>.
>>>> To post to this group, send email to cgd-cseg at ucar.edu <mailto:cgd-cseg at ucar.edu>.
>>>> To view this discussion on the web visit https://groups.google.com/a/ucar.edu/d/msgid/cgd-cseg/CA%2BadaiB7N_yb3iNr0a5awBJg_Mvh5nc7%2B_skQ1Bxb6_3EfuL4A%40mail.gmail.com <https://groups.google.com/a/ucar.edu/d/msgid/cgd-cseg/CA%2BadaiB7N_yb3iNr0a5awBJg_Mvh5nc7%2B_skQ1Bxb6_3EfuL4A%40mail.gmail.com>.
>>> 
>>> _______________________________________________
>>> Liwg-core mailing list
>>> Liwg-core at cgd.ucar.edu <mailto:Liwg-core at cgd.ucar.edu>
>>> http://mailman.cgd.ucar.edu/mailman/listinfo/liwg-core <http://mailman.cgd.ucar.edu/mailman/listinfo/liwg-core>
>> 
> 
> 
> _______________________________________________
> Liwg-core mailing list
> Liwg-core at cgd.ucar.edu <mailto:Liwg-core at cgd.ucar.edu>
> http://mailman.cgd.ucar.edu/mailman/listinfo/liwg-core <http://mailman.cgd.ucar.edu/mailman/listinfo/liwg-core>
> 
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.cgd.ucar.edu/pipermail/liwg-core/attachments/20170308/cb560451/attachment-0001.html>


More information about the Liwg-core mailing list