[{"data":1,"prerenderedAt":590},["ShallowReactive",2],{"page-\u002Fcontributing":3,"navigation":212},{"collection":4,"page":5},"docs_en",{"id":6,"title":7,"body":8,"description":202,"extension":203,"meta":204,"navigation":205,"path":207,"rawbody":208,"seo":209,"stem":210,"__hash__":211},"docs_en\u002Fcontributing\u002Findex.md","Contributing",{"type":9,"value":10,"toc":194},"minimark",[11,23,28,139,148,152,160,164,181,185],[12,13,14,15,22],"p",{},"Welldot is open source (Apache 2.0) and developed in the open on ",[16,17,21],"a",{"href":18,"rel":19},"https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot",[20],"nofollow","GitHub",". Contributions of every size help: a typo fix, a clearer example, a missing vocabulary value, a converter for another registry.",[24,25,27],"h2",{"id":26},"where-things-live","Where things live",[29,30,31,47],"table",{},[32,33,34],"thead",{},[35,36,37,41,44],"tr",{},[38,39,40],"th",{},"You want to change",[38,42,43],{},"Where",[38,45,46],{},"Start with",[48,49,50,75,95,113,126],"tbody",{},[35,51,52,61,67],{},[53,54,55,56,60],"td",{},"A rule of the ",[57,58,59],"code",{},".well"," format",[53,62,63,66],{},[57,64,65],{},"spec\u002F"," (plain Markdown)",[53,68,69,70,74],{},"An issue describing the need (",[16,71,73],{"href":72},"\u002Fformat\u002Fguides\u002Fextending#propose-a-change-to-the-format","Extending the format",")",[35,76,77,80,92],{},[53,78,79],{},"A package's behavior or API",[53,81,82,85,86,85,89],{},[57,83,84],{},"packages\u002Fcore",", ",[57,87,88],{},"packages\u002Futils",[57,90,91],{},"packages\u002Frender",[53,93,94],{},"An issue or a pull request with tests and a changeset",[35,96,97,100,105],{},[53,98,99],{},"A docs page (guides, concepts, getting started)",[53,101,102],{},[57,103,104],{},"apps\u002Fdocs\u002Fcontent\u002Fen\u002F",[53,106,107,108,112],{},"A pull request; use ",[109,110,111],"strong",{},"Edit this page"," at the side of any page",[35,114,115,118,123],{},[53,116,117],{},"The site itself (layout, components, MCP server)",[53,119,120],{},[57,121,122],{},"apps\u002Fdocs\u002F",[53,124,125],{},"An issue first for anything large",[35,127,128,131,136],{},[53,129,130],{},"The conversion skill",[53,132,133],{},[57,134,135],{},".agents\u002Fskills\u002Fwelldot-converter\u002F",[53,137,138],{},"A pull request",[12,140,141,142,147],{},"The repository's ",[16,143,146],{"href":144,"rel":145},"https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot\u002Fblob\u002Fmain\u002FCONTRIBUTING.md",[20],"CONTRIBUTING.md"," covers setup, branches, commits and releases.",[24,149,151],{"id":150},"changes-that-touch-the-docs","Changes that touch the docs",[12,153,154,155,159],{},"A change to the spec or to a package's public API usually needs a docs change in the same pull request. ",[16,156,158],{"href":157},"\u002Fcontributing\u002Fupdate-rules","Update rules"," says exactly what, and CI checks the parts that can be checked: examples must validate, links and spec anchors must resolve, and the site must build.",[24,161,163],{"id":162},"writing-docs","Writing docs",[165,166,167,174],"ul",{},[168,169,170,173],"li",{},[16,171,163],{"href":172},"\u002Fcontributing\u002Fwriting-docs",": the writing rules, how to add a page and how to run the site locally.",[168,175,176,180],{},[16,177,179],{"href":178},"\u002Fcontributing\u002Fcomponents","Content components",": callouts, Do\u002FDon't blocks, code groups, diagrams and live well previews, with their Markdown.",[24,182,184],{"id":183},"reporting-a-problem","Reporting a problem",[12,186,187,188,193],{},"Found a page that is wrong, unclear or out of date? Open an ",[16,189,192],{"href":190,"rel":191},"https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot\u002Fissues",[20],"issue"," with the page address and what you expected. For a mistake in the specification itself, say which section and quote the text.",{"title":195,"searchDepth":196,"depth":196,"links":197},"",2,[198,199,200,201],{"id":26,"depth":196,"text":27},{"id":150,"depth":196,"text":151},{"id":162,"depth":196,"text":163},{"id":183,"depth":196,"text":184},"How to contribute to welldot, from reporting a problem with the docs to proposing a change to the .well format, and where each kind of change lives.","md",{},{"title":206},"Introduction","\u002Fcontributing","---\ntitle: Contributing\ndescription: How to contribute to welldot, from reporting a problem with the docs to proposing a change to the .well format, and where each kind of change lives.\nnavigation:\n  title: Introduction\n---\n\nWelldot is open source (Apache 2.0) and developed in the open on [GitHub](https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot). Contributions of every size help: a typo fix, a clearer example, a missing vocabulary value, a converter for another registry.\n\n## Where things live\n\n| You want to change                               | Where                                                | Start with                                                                                                     |\n| ------------------------------------------------ | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |\n| A rule of the `.well` format                     | `spec\u002F` (plain Markdown)                             | An issue describing the need ([Extending the format](\u002Fformat\u002Fguides\u002Fextending#propose-a-change-to-the-format)) |\n| A package's behavior or API                      | `packages\u002Fcore`, `packages\u002Futils`, `packages\u002Frender` | An issue or a pull request with tests and a changeset                                                          |\n| A docs page (guides, concepts, getting started)  | `apps\u002Fdocs\u002Fcontent\u002Fen\u002F`                              | A pull request; use **Edit this page** at the side of any page                                                 |\n| The site itself (layout, components, MCP server) | `apps\u002Fdocs\u002F`                                         | An issue first for anything large                                                                              |\n| The conversion skill                             | `.agents\u002Fskills\u002Fwelldot-converter\u002F`                  | A pull request                                                                                                 |\n\nThe repository's [CONTRIBUTING.md](https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot\u002Fblob\u002Fmain\u002FCONTRIBUTING.md) covers setup, branches, commits and releases.\n\n## Changes that touch the docs\n\nA change to the spec or to a package's public API usually needs a docs change in the same pull request. [Update rules](\u002Fcontributing\u002Fupdate-rules) says exactly what, and CI checks the parts that can be checked: examples must validate, links and spec anchors must resolve, and the site must build.\n\n## Writing docs\n\n- [Writing docs](\u002Fcontributing\u002Fwriting-docs): the writing rules, how to add a page and how to run the site locally.\n- [Content components](\u002Fcontributing\u002Fcomponents): callouts, Do\u002FDon't blocks, code groups, diagrams and live well previews, with their Markdown.\n\n## Reporting a problem\n\nFound a page that is wrong, unclear or out of date? Open an [issue](https:\u002F\u002Fgithub.com\u002Fwelldothq\u002Fwelldot\u002Fissues) with the page address and what you expected. For a mistake in the specification itself, say which section and quote the text.\n",{"title":7,"description":202},"contributing\u002Findex","CjLaX39nArKHZiYvhknoYJbyVXVAPr3UU5L8Zpd3iwQ",{"docs_en":213,"spec":521,"changelogs":571},[214,233,243,299,409,463],{"title":215,"path":216,"stem":217,"children":218},"Ai","\u002Fai","ai",[219,221,225,229],{"title":206,"path":216,"stem":220},"ai\u002Findex",{"title":222,"path":223,"stem":224},"Converting reports with an assistant","\u002Fai\u002Fconversion-skill","ai\u002Fconversion-skill",{"title":226,"path":227,"stem":228},"llms.txt and Markdown pages","\u002Fai\u002Fllms","ai\u002Fllms",{"title":230,"path":231,"stem":232},"MCP server","\u002Fai\u002Fmcp","ai\u002Fmcp",{"title":7,"path":207,"stem":234,"children":235},"contributing",[236,237,239,241],{"title":206,"path":207,"stem":210},{"title":163,"path":172,"stem":238},"contributing\u002F1.writing-docs",{"title":158,"path":157,"stem":240},"contributing\u002F2.update-rules",{"title":179,"path":178,"stem":242},"contributing\u002Fcomponents",{"title":244,"path":245,"stem":246,"children":247},"Core","\u002Fcore","core",[248,250,264,293],{"title":206,"path":245,"stem":249},"core\u002Findex",{"title":251,"path":252,"stem":253,"children":254,"page":263},"Getting Started","\u002Fcore\u002Fgetting-started","core\u002F1.getting-started",[255,259],{"title":256,"path":257,"stem":258},"Installation","\u002Fcore\u002Fgetting-started\u002Finstallation","core\u002F1.getting-started\u002F1.installation",{"title":260,"path":261,"stem":262},"First use","\u002Fcore\u002Fgetting-started\u002Ffirst-use","core\u002F1.getting-started\u002F2.first-use",false,{"title":265,"path":266,"stem":267,"children":268,"page":263},"Guides","\u002Fcore\u002Fguides","core\u002F2.guides",[269,273,277,281,285,289],{"title":270,"path":271,"stem":272},"Parsing and validating","\u002Fcore\u002Fguides\u002Fparsing-and-validating","core\u002F2.guides\u002F1.parsing-and-validating",{"title":274,"path":275,"stem":276},"Serializing and sharing","\u002Fcore\u002Fguides\u002Fserializing-and-sharing","core\u002F2.guides\u002F2.serializing-and-sharing",{"title":278,"path":279,"stem":280},"Unit conversion","\u002Fcore\u002Fguides\u002Funit-conversion","core\u002F2.guides\u002F3.unit-conversion",{"title":282,"path":283,"stem":284},"Vocabularies and textures","\u002Fcore\u002Fguides\u002Fvocabularies-and-textures","core\u002F2.guides\u002F4.vocabularies-and-textures",{"title":286,"path":287,"stem":288},"Water quality vocabulary","\u002Fcore\u002Fguides\u002Fwater-quality-vocabulary","core\u002F2.guides\u002F5.water-quality-vocabulary",{"title":290,"path":291,"stem":292},"Versions and time zones","\u002Fcore\u002Fguides\u002Fversions-and-time-zones","core\u002F2.guides\u002F6.versions-and-time-zones",{"title":294,"path":295,"stem":296,"children":297},"API reference","\u002Fcore\u002Fapi","core\u002Fapi\u002Findex",[298],{"title":294,"path":295,"stem":296},{"title":300,"path":301,"stem":302,"children":303},"Format","\u002Fformat","format",[304,306,326,355,379,399,405],{"title":206,"path":301,"stem":305},"format\u002Findex",{"title":251,"path":307,"stem":308,"children":309,"page":263},"\u002Fformat\u002Fgetting-started","format\u002F1.getting-started",[310,314,318,322],{"title":311,"path":312,"stem":313},"What is .well?","\u002Fformat\u002Fgetting-started\u002Fwhat-is-well","format\u002F1.getting-started\u002F1.what-is-well",{"title":315,"path":316,"stem":317},"For geologists","\u002Fformat\u002Fgetting-started\u002Ffor-geologists","format\u002F1.getting-started\u002F2.for-geologists",{"title":319,"path":320,"stem":321},"For developers","\u002Fformat\u002Fgetting-started\u002Ffor-developers","format\u002F1.getting-started\u002F3.for-developers",{"title":323,"path":324,"stem":325},"Your first .well file","\u002Fformat\u002Fgetting-started\u002Ffirst-well-file","format\u002F1.getting-started\u002F4.first-well-file",{"title":327,"path":328,"stem":329,"children":330,"page":263},"Concepts","\u002Fformat\u002Fconcepts","format\u002F2.concepts",[331,335,339,343,347,351],{"title":332,"path":333,"stem":334},"Depths and intervals","\u002Fformat\u002Fconcepts\u002Fdepths-and-intervals","format\u002F2.concepts\u002F1.depths-and-intervals",{"title":336,"path":337,"stem":338},"Units and precision","\u002Fformat\u002Fconcepts\u002Funits-and-precision","format\u002F2.concepts\u002F2.units-and-precision",{"title":340,"path":341,"stem":342},"Vocabularies","\u002Fformat\u002Fconcepts\u002Fvocabularies","format\u002F2.concepts\u002F3.vocabularies",{"title":344,"path":345,"stem":346},"Profiles","\u002Fformat\u002Fconcepts\u002Fprofiles","format\u002F2.concepts\u002F4.profiles",{"title":348,"path":349,"stem":350},"Versions and deprecation","\u002Fformat\u002Fconcepts\u002Fversions-and-deprecation","format\u002F2.concepts\u002F5.versions-and-deprecation",{"title":352,"path":353,"stem":354},"Extensibility","\u002Fformat\u002Fconcepts\u002Fextensibility","format\u002F2.concepts\u002F6.extensibility",{"title":265,"path":356,"stem":357,"children":358,"page":263},"\u002Fformat\u002Fguides","format\u002F3.guides",[359,363,367,371,375],{"title":360,"path":361,"stem":362},"Writing a .well by hand","\u002Fformat\u002Fguides\u002Fwriting-by-hand","format\u002F3.guides\u002F1.writing-by-hand",{"title":364,"path":365,"stem":366},"Converting a report","\u002Fformat\u002Fguides\u002Fconverting-a-report","format\u002F3.guides\u002F2.converting-a-report",{"title":368,"path":369,"stem":370},"Validating","\u002Fformat\u002Fguides\u002Fvalidating","format\u002F3.guides\u002F3.validating",{"title":372,"path":373,"stem":374},"Extending for your own needs","\u002Fformat\u002Fguides\u002Fextending","format\u002F3.guides\u002F4.extending",{"title":376,"path":377,"stem":378},"Building an editor or database on .well","\u002Fformat\u002Fguides\u002Fbuilding-on-well","format\u002F3.guides\u002F5.building-on-well",{"title":380,"path":381,"stem":382,"children":383},"Overview","\u002Fformat\u002Freference","format\u002F4.reference\u002Findex",[384,385,389,393],{"title":380,"path":381,"stem":382},{"title":386,"path":387,"stem":388},"JSON Schema","\u002Fformat\u002Freference\u002Fjson-schema","format\u002F4.reference\u002F1.json-schema",{"title":390,"path":391,"stem":392},"Example wells","\u002Fformat\u002Freference\u002Fexamples","format\u002F4.reference\u002F2.examples",{"title":394,"path":395,"stem":396,"children":397},"Object reference","\u002Fformat\u002Freference\u002Fobjects","format\u002Freference\u002Fobjects\u002Findex",[398],{"title":394,"path":395,"stem":396},{"title":400,"path":401,"stem":402,"children":403},"About the spec","\u002Fformat\u002Fspec","format\u002F5.spec\u002Findex",[404],{"title":400,"path":401,"stem":402},{"title":406,"path":407,"stem":408},"Changelog","\u002Fformat\u002Fchangelog","format\u002F6.changelog",{"title":410,"path":411,"stem":412,"children":413},"Render","\u002Frender","render",[414,416,426,458],{"title":206,"path":411,"stem":415},"render\u002Findex",{"title":251,"path":417,"stem":418,"children":419,"page":263},"\u002Frender\u002Fgetting-started","render\u002F1.getting-started",[420,423],{"title":256,"path":421,"stem":422},"\u002Frender\u002Fgetting-started\u002Finstallation","render\u002F1.getting-started\u002F1.installation",{"title":260,"path":424,"stem":425},"\u002Frender\u002Fgetting-started\u002Ffirst-use","render\u002F1.getting-started\u002F2.first-use",{"title":265,"path":427,"stem":428,"children":429,"page":263},"\u002Frender\u002Fguides","render\u002F2.guides",[430,434,438,442,446,450,454],{"title":431,"path":432,"stem":433},"Panels and layout","\u002Frender\u002Fguides\u002Fpanels-and-layout","render\u002F2.guides\u002F1.panels-and-layout",{"title":435,"path":436,"stem":437},"Layers and labels","\u002Frender\u002Fguides\u002Flayers-and-labels","render\u002F2.guides\u002F2.layers-and-labels",{"title":439,"path":440,"stem":441},"Theming","\u002Frender\u002Fguides\u002Ftheming","render\u002F2.guides\u002F3.theming",{"title":443,"path":444,"stem":445},"Locale and units","\u002Frender\u002Fguides\u002Flocale-and-units","render\u002F2.guides\u002F4.locale-and-units",{"title":447,"path":448,"stem":449},"Legends","\u002Frender\u002Fguides\u002Flegends","render\u002F2.guides\u002F5.legends",{"title":451,"path":452,"stem":453},"Zoom, pan and highlights","\u002Frender\u002Fguides\u002Finteraction","render\u002F2.guides\u002F6.interaction",{"title":455,"path":456,"stem":457},"Using it in a framework","\u002Frender\u002Fguides\u002Fframeworks","render\u002F2.guides\u002F7.frameworks",{"title":294,"path":459,"stem":460,"children":461},"\u002Frender\u002Fapi","render\u002Fapi\u002Findex",[462],{"title":294,"path":459,"stem":460},{"title":464,"path":465,"stem":466,"children":467},"Utils","\u002Futils","utils",[468,470,480,516],{"title":206,"path":465,"stem":469},"utils\u002Findex",{"title":251,"path":471,"stem":472,"children":473,"page":263},"\u002Futils\u002Fgetting-started","utils\u002F1.getting-started",[474,477],{"title":256,"path":475,"stem":476},"\u002Futils\u002Fgetting-started\u002Finstallation","utils\u002F1.getting-started\u002F1.installation",{"title":260,"path":478,"stem":479},"\u002Futils\u002Fgetting-started\u002Ffirst-use","utils\u002F1.getting-started\u002F2.first-use",{"title":265,"path":481,"stem":482,"children":483,"page":263},"\u002Futils\u002Fguides","utils\u002F2.guides",[484,488,492,496,500,504,508,512],{"title":485,"path":486,"stem":487},"Geometry and volumes","\u002Futils\u002Fguides\u002Fgeometry-and-volumes","utils\u002F2.guides\u002F1.geometry-and-volumes",{"title":489,"path":490,"stem":491},"Water levels and pumping tests","\u002Futils\u002Fguides\u002Fpumping-tests","utils\u002F2.guides\u002F2.pumping-tests",{"title":493,"path":494,"stem":495},"Permits","\u002Futils\u002Fguides\u002Fpermits","utils\u002F2.guides\u002F3.permits",{"title":497,"path":498,"stem":499},"Operation and production","\u002Futils\u002Fguides\u002Foperation","utils\u002F2.guides\u002F4.operation",{"title":501,"path":502,"stem":503},"Water quality","\u002Futils\u002Fguides\u002Fwater-quality","utils\u002F2.guides\u002F5.water-quality",{"title":505,"path":506,"stem":507},"Logger import","\u002Futils\u002Fguides\u002Flogger-import","utils\u002F2.guides\u002F6.logger-import",{"title":509,"path":510,"stem":511},"SIAGAS import","\u002Futils\u002Fguides\u002Fsiagas-import","utils\u002F2.guides\u002F7.siagas-import",{"title":513,"path":514,"stem":515},"Formatting","\u002Futils\u002Fguides\u002Fformatting","utils\u002F2.guides\u002F8.formatting",{"title":294,"path":517,"stem":518,"children":519},"\u002Futils\u002Fapi","utils\u002Fapi\u002Findex",[520],{"title":294,"path":517,"stem":518},[522],{"title":300,"path":301,"stem":302,"children":523,"page":263},[524],{"title":525,"path":401,"stem":526,"children":527,"page":263},"Spec","format\u002Fspec",[528,537,546],{"title":529,"path":530,"stem":531,"children":532,"page":263},"Reference","\u002Fformat\u002Fspec\u002Freference","format\u002Fspec\u002Freference",[533],{"title":534,"path":535,"stem":536},"FGDC Texture Patterns Reference","\u002Fformat\u002Fspec\u002Freference\u002Ffgdc-textures","format\u002Fspec\u002Freference\u002Ffgdc-textures",{"title":538,"path":539,"stem":540,"children":541,"page":263},"V1","\u002Fformat\u002Fspec\u002Fv1","format\u002Fspec\u002Fv1",[542],{"title":543,"path":544,"stem":545},".well File Format Specification","\u002Fformat\u002Fspec\u002Fv1\u002Fwell-format","format\u002Fspec\u002Fv1\u002Fwell-format",{"title":547,"path":548,"stem":549,"children":550,"page":263},"V2","\u002Fformat\u002Fspec\u002Fv2","format\u002Fspec\u002Fv2",[551,555,559,563,567],{"title":552,"path":553,"stem":554},".well File Format Specification — Version 2.4: Format Reference","\u002Fformat\u002Fspec\u002Fv2\u002Fformat-reference","format\u002Fspec\u002Fv2\u002Fformat-reference",{"title":556,"path":557,"stem":558},".well File Format Specification — Version 2.4: Interoperability","\u002Fformat\u002Fspec\u002Fv2\u002Finteroperability","format\u002Fspec\u002Fv2\u002Finteroperability",{"title":560,"path":561,"stem":562},".well File Format Specification — Version 2.4: Object Schemas","\u002Fformat\u002Fspec\u002Fv2\u002Fobject-schemas","format\u002Fspec\u002Fv2\u002Fobject-schemas",{"title":564,"path":565,"stem":566},".well File Format Specification — Version 2.4: Overview","\u002Fformat\u002Fspec\u002Fv2\u002Foverview","format\u002Fspec\u002Fv2\u002Foverview",{"title":568,"path":569,"stem":570},".well File Format Specification — Version 2.4: Water Quality","\u002Fformat\u002Fspec\u002Fv2\u002Fwater-quality","format\u002Fspec\u002Fv2\u002Fwater-quality",[572,578,584],{"title":244,"path":245,"stem":246,"children":573,"page":263},[574],{"title":575,"path":576,"stem":577},"@welldot\u002Fcore","\u002Fcore\u002Fchangelog","core\u002FCHANGELOG",{"title":410,"path":411,"stem":412,"children":579,"page":263},[580],{"title":581,"path":582,"stem":583},"@welldot\u002Frender","\u002Frender\u002Fchangelog","render\u002FCHANGELOG",{"title":464,"path":465,"stem":466,"children":585,"page":263},[586],{"title":587,"path":588,"stem":589},"@welldot\u002Futils","\u002Futils\u002Fchangelog","utils\u002FCHANGELOG",1793050492597]