With less than a week to go before the big day (aaaaaaah), we're putting the finishing touches on some important updates to the website and the documentation.

Starting Tuesday Jan 9, the primary supported version will be 4.0, so all the documentation displayed by default on the website will be the 4.0 documentation. That covers not just the Tool Docs, which have always been systematically versioned, but also the forum-based peripheral docs that are more general and typically do not change from one version to the next. In the case of the move to GATK4, a majority of these peripheral doc articles are affected by a range of changes, from minor points of syntax to major shifts in functionality (e.g. switching from -nt/-nct to Spark for multithreading). Here's how we're planning to deal with that.

In order to preserve access to a GATK3-compatible form of the not-traditionally-versioned documentation (because we recognize that moving to 4.0 is a non-trivial change), we have cloned ALL THE DOCS! This allows us to freeze the originals for perpetuity (or however long we have until the Machines take over) and to update the clones freely as we move into the GATK4 era.

In practice what this means is that there will be two parallel set of docs on the website. The GATK4 set will be displayed by default, while the GATK3 set will be accessible through either a button or a drop-down menu (exact UI still TBD because it would be boring to have everything ready way ahead of time). If we ever switch to GATK5 during my lifetime (I might be psychologically ready in another 20 years), we will use the same mechanism then. And in case you're worried/wondering, ALL EXISTING LINKS WILL REMAIN VALID. But we'll add a note at the top of all GATK3-era docs to make it clear that they are the legacy version. We will probably not be able to put in a direct link to the replacement doc, at least not in the immediate future, because there are so many of them and so few of us but we might try to get that done (or crowd-source it) down the road.

HOWEVER. Not everything will coexist in this two-state-solution form: there will be a few things that change permanently to be GATK4-only on the website.

  • The Quick Start Guide (formerly Getting Started) will be GATK4-only.
  • The Best Practices documentation will also be GATK4-only, although there will be versioned workflow implementations available that will make it possible to go back in time if needed.
  • Pipelining Options will be consolidated to only cover Cromwell and WDL, so no more talk of Queue please (may it rest in peace).
  • Version History will be essentially the same thing but with a facelift.
  • Presentations (including tutorial materials) from past workshops will remain available indefinitely -- or until all of Google's storage space gets filled up with BAM files.
  • Bugs & Feature Requests (previously Issue Tracker) has been GATK4-only for some time so that will continue. I'm not super happy with the setup we have for that section so further improvements may be in the works, but not for a little while. Feel free to suggest ideas.

The other sections of the website will be mostly unchanged, save for some freshening up. The one real change is that everything related to licensing will be updated, thank goodness, since in the brave new world of GATK4 everything is open-source (huzzah!); and the Download section will look a bit different, though it will still provide access to older binaries. Oh, and before I forget, the "Documentation" section will now be called "User Guide" (as it was for a while a long time ago) because survey says it's what people prefer.

There will also be a migration guide that specifically points out key differences between GATK3 and GATK4 to help ease the transition... but that's a story for another time.

Return to top

mglclinical on 4 Jan 2018

Thank you for the post @Geraldine_VdAuwera

- Recent posts

- Upcoming events

See Events calendar for full list and dates

- Recent events

See Events calendar for full list and dates

- Follow us on Twitter

GATK Dev Team


Our very own Andrey Smirnov is delighted to answer questions about the #GATK4 pipeline for common and rare germline… https://t.co/cpCe37W4Ul
17 Oct 18
@cpj3131 Depending on the tool you're using, some filters get applied that may modify what ends up getting counted.… https://t.co/yTGPKrsB9A
15 Oct 18
@cpj3131 It's a variant context annotation that counts the number of A, C, G, and T bases across all samples, in th… https://t.co/gVhAdpqOIv
13 Oct 18
Big day for #GATK users on AWS -- this means you can now run our #OpenWDL Best Practices workflows a lot more easil… https://t.co/y08881uLLv
1 Oct 18
@PoisonEcology @macmanes Hmm yeah that sounds potentially problematic, will take a look on Monday.
29 Sep 18

- Our favorite tweets from others

#ASHG18 VA: call with GATK @gatk_dev. Look for pathogenic / likely pathogenic. leverage ClinVar.
17 Oct 18
If you think your fascination with #GATK hit the roof wait until you meet @gatk_dev team! Has been a wonderful week… https://t.co/KwfHm1SzNh
21 Sep 18
@xdopazo @gatk_dev @ClinicalBioinfo @FProgresoysalud @INB_Official @CIBERER @jpflorido Thank you very much for such amazing time!
21 Sep 18
Workshop "From reads to disease variants". Big thanks to @gatk_dev staff for sharing #GATK4 variant calling apps' e… https://t.co/kwjCA9HCy6
21 Sep 18

See more of our favorite tweets...