# ITK Documentation Hackathon, November 2023! The [Insight Toolkit (ITK)](https://docs.itk.org) is an open-source, cross-platform toolkit for N-dimensional scientific image processing, segmentation, and registration. The ITK Documentation Hackathon aims to bring together ITK developers and new users to expand documentation and learn to use ITK tools for scientific image processing. We will focus on expanding and adding to new Sphinx documentation [docs.itk.org](https://docs.itk.org) by migrating content from [the wiki](https://itk.org/Wiki/ITK). [![](https://hackmd.io/_uploads/rkPsAoT-p.png)](https://docs.itk.org) *Shiny new documentation portal.* [![](https://hackmd.io/_uploads/BksuAoa-p.png)](https://itk.org/Wiki/ITK#Overview) *Ye olde wiki.* ## Why Attend? - Learn: Want to learn to use ITK, but not sure where to get started? Join the discussion and take your first steps with the ITK! - Contribute: Have you found a great way to apply ITK in your scientific imaging work? Create an example to share your process with other community members! - Meet: Want to interact with the ITK and scientific image processing community? Come meet the developers behind the curtain! ## Mark Your Calendar - Date: November 8th, 2023 - Time: 10am - 5pm EST - Where: [Google Meet](https://meet.google.com/kng-pure-gma) - Who: Anyone interested in contributing to the ITK open source community! ## Prepare for the Hackathon - **Take a few seconds to [register](https://forms.gle/SfHcNkcH98x2Fvaj7)** - Visit the ITK GitHub repository - [https://github.com/InsightSoftwareConsortium/ITK](https://github.com/InsightSoftwareConsortium/ITK) - Create a GitHub account and fork the [ITK](https://github.com/InsightSoftwareConsortium/ITK) repository - [Build the documentation locally](https://github.com/InsightSoftwareConsortium/ITK/tree/master/Documentation) - Read ITK's [guide to contributing](https://docs.itk.org/en/latest/contributing/index.html) ## During the Hackathon - Migrate content from the [ITK Wiki](https://itk.org/Wiki/ITK) to the [new documentation](https://docs.itk.org). - Collaborate on other ITK-related projects of your choice. - Chat with other attendees to learn about ITK and share perspectives - Participants are expected to adhere to [ITK's Code of Conduct](https://docs.itk.org/en/latest/contributing/code_of_conduct.html) - (Recommended) **Have fun!** ### Assign yourself a task If you would like a task to work on during the hackathon, a list is provided below. Please add your GitHub handle next to a task when you start working on it. - Migrate ITK Wiki pages to docs.itk.org - [instructions](https://github.com/InsightSoftwareConsortium/ITK/tree/master/Documentation) - [Getting Started](https://itk.org/Wiki/ITK/Getting_Started) - - [About - translate more up-to-date page itk.org/about to markdown](https://itk.org/about/) - - [FAQ](https://itk.org/Wiki/ITK/FAQ) - jhlegarreta - [License](https://itk.org/Wiki/ITK/License_Information), integrate with [NOTICE](https://github.com/InsightSoftwareConsortium/ITK/blob/master/NOTICE), change NOTICE to markdown - thewtex - [PR](https://github.com/InsightSoftwareConsortium/ITK/pull/4303) - Add [CDash link](http://www.cdash.org/CDash/index.php?project=Insight&date=) - thewtex - [PR](https://github.com/InsightSoftwareConsortium/ITK/pull/4304) - Mark [Version control and releases](https://itk.org/Wiki/ITK/Development) wiki pages with `{{ Historical }}` - - [Configuring and building](https://itk.org/Wiki/ITK/Configuring_and_Building) - - [Compilers](https://itk.org/Wiki/ITK/Compilers), integrate with [updated version](https://github.com/InsightSoftwareConsortium/ITK/blob/master/Documentation/SupportedCompilers.md) - thewtex - [PR](https://github.com/InsightSoftwareConsortium/ITK/pull/4305) - [Branches](https://itk.org/Wiki/ITK/Release_4/Branches) - - [Doxygen Documentation](https://itk.org/Wiki/ITK/Doxygen_Documentation) - - [ITKDoxygen on GitHub](https://github.com/InsightSoftwareConsortium/ITKDoxygen) - [Dashboard Setup](https://itk.org/Wiki/ITK/Git/Dashboard) - [Developer statistics (new system?)](https://itk.org/Wiki/ITK/Statistics) - [Plugin IO mechanisms](https://itk.org/Wiki/Plugin_IO_mechanisms) - - [Open Science](https://itk.org/Wiki/ITK/Open_Science) - - [Other Software](https://itk.org/Wiki/ITK/Other_Software) - - [MetaIO](https://itk.org/Wiki/MetaIO) - - Work on [example issues](https://github.com/InsightSoftwareConsortium/ITKSphinxExamples/labels/Good%20first%20issue) - [#308](https://github.com/InsightSoftwareConsortium/ITKSphinxExamples/issues/308) - [...] - - Work on [ITK Documentation issues](https://github.com/InsightSoftwareConsortium/ITK/issues?q=is%3Aopen+is%3Aissue+label%3Atype%3ADocumentation) - [#4291](https://github.com/InsightSoftwareConsortium/ITK/issues/4291) - [#4300](https://github.com/InsightSoftwareConsortium/ITK/issues/4300) - [...] - Migrate the [ITKPythonPackage docs](https://github.com/InsightSoftwareConsortium/ITKPythonPackage/tree/master/docs) - tbirdso - Migrate the [remote module GitHub Action docs](https://github.com/InsightSoftwareConsortium/ITKRemoteModuleBuildTestPackageAction) - tbirdso - Migrate the [ITK v5 Migration Guide](https://github.com/InsightSoftwareConsortium/ITK/blob/master/Documentation/ITK5MigrationGuide.md) - thewtex - [PR](https://github.com/InsightSoftwareConsortium/ITK/pull/4297) ## Acknowledgements This hackathon is supported by the [Insight Software Consortium (ISC)](https://insightsoftwareconsortium.org/) via [NumFOCUS](https://numfocus.org/). ITK is a fiscally sponsored project of [NumFOCUS](https://numfocus.org), a non-profit dedicated to supporting the open source scientific computing community. If you want to support ISC's mission to promote and maintain open-source, freely available software for medical image analysis in teaching, research, and commercial applications, please consider making a [donation](https://opencollective.com/itk) to support our efforts.