Skip to content

Commit

Permalink
updating documentation and release process to include rebuilding docs
Browse files Browse the repository at this point in the history
  • Loading branch information
heckj committed Mar 6, 2024
1 parent 197e642 commit a260487
Show file tree
Hide file tree
Showing 345 changed files with 47,288 additions and 0 deletions.
8 changes: 8 additions & 0 deletions devnotes/release-process.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,10 +85,18 @@ git push origin --tags

![GitHub release page after creation.](./github_release_ready.png)

### update the documentation

- run the script `./scripts/docbuild.bash`
- commit and push the updates on the `main` branch

## Oops, I made a mistake - what do I do?

If something in the process goes awry, don't worry - that happens.
_Do not_ attempt to delete or move any tsgs that you've made.
Instead, just move on to the next semantic version and call it a day.
For example, when I was testing this process, I learned about the unsafe flags constraint at the last minute.
To resolve this, I repeated the process with the next tag `0.1.1` even though it didn't have any meaningful changes in the code.



9 changes: 9 additions & 0 deletions docs/css/523.e9a069b0.css

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions docs/css/675.40c3bcb2.css

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

9 changes: 9 additions & 0 deletions docs/css/documentation-topic.b186e79f.css

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions docs/css/index.ff036a9e.css

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions docs/css/topic.672a9049.css

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions docs/css/tutorials-overview.6eb589ed.css

Large diffs are not rendered by default.

254 changes: 254 additions & 0 deletions docs/data/documentation/yniffi/fficonvertertypeyrsarray_lift(_:).json
Original file line number Diff line number Diff line change
@@ -0,0 +1,254 @@
{
"hierarchy" : {
"paths" : [
[
"doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi"
]
]
},
"identifier" : {
"interfaceLanguage" : "swift",
"url" : "doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi\/FfiConverterTypeYrsArray_lift(_:)"
},
"kind" : "symbol",
"metadata" : {
"externalID" : "s:6Yniffi29FfiConverterTypeYrsArray_liftyAA0eF0CSvKF",
"fragments" : [
{
"kind" : "keyword",
"text" : "func"
},
{
"kind" : "text",
"text" : " "
},
{
"kind" : "identifier",
"text" : "FfiConverterTypeYrsArray_lift"
},
{
"kind" : "text",
"text" : "("
},
{
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:Sv",
"text" : "UnsafeMutableRawPointer"
},
{
"kind" : "text",
"text" : ") "
},
{
"kind" : "keyword",
"text" : "throws"
},
{
"kind" : "text",
"text" : " -> "
},
{
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:6Yniffi8YrsArrayC",
"text" : "YrsArray"
}
],
"modules" : [
{
"name" : "Yniffi"
}
],
"role" : "symbol",
"roleHeading" : "Function",
"symbolKind" : "func",
"title" : "FfiConverterTypeYrsArray_lift(_:)"
},
"primaryContentSections" : [
{
"declarations" : [
{
"languages" : [
"swift"
],
"platforms" : [
"macOS"
],
"tokens" : [
{
"kind" : "keyword",
"text" : "func"
},
{
"kind" : "text",
"text" : " "
},
{
"kind" : "identifier",
"text" : "FfiConverterTypeYrsArray_lift"
},
{
"kind" : "text",
"text" : "("
},
{
"kind" : "externalParam",
"text" : "_"
},
{
"kind" : "text",
"text" : " "
},
{
"kind" : "internalParam",
"text" : "pointer"
},
{
"kind" : "text",
"text" : ": "
},
{
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:Sv",
"text" : "UnsafeMutableRawPointer"
},
{
"kind" : "text",
"text" : ") "
},
{
"kind" : "keyword",
"text" : "throws"
},
{
"kind" : "text",
"text" : " -> "
},
{
"identifier" : "doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi\/YrsArray",
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:6Yniffi8YrsArrayC",
"text" : "YrsArray"
}
]
}
],
"kind" : "declarations"
}
],
"schemaVersion" : {
"major" : 0,
"minor" : 3,
"patch" : 0
},
"sections" : [

],
"variants" : [
{
"paths" : [
"\/documentation\/yniffi\/fficonvertertypeyrsarray_lift(_:)"
],
"traits" : [
{
"interfaceLanguage" : "swift"
}
]
}
]
,
"references": {
"doc://com.github.y-crdt.YSwift/documentation/Yniffi": {
"abstract" : [

],
"identifier" : "doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi",
"kind" : "symbol",
"role" : "collection",
"title" : "Yniffi",
"type" : "topic",
"url" : "\/documentation\/yniffi"
},
"doc://com.github.y-crdt.YSwift/documentation/Yniffi/FfiConverterTypeYrsArray_lift(_:)": {
"abstract" : [

],
"fragments" : [
{
"kind" : "keyword",
"text" : "func"
},
{
"kind" : "text",
"text" : " "
},
{
"kind" : "identifier",
"text" : "FfiConverterTypeYrsArray_lift"
},
{
"kind" : "text",
"text" : "("
},
{
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:Sv",
"text" : "UnsafeMutableRawPointer"
},
{
"kind" : "text",
"text" : ") "
},
{
"kind" : "keyword",
"text" : "throws"
},
{
"kind" : "text",
"text" : " -> "
},
{
"kind" : "typeIdentifier",
"preciseIdentifier" : "s:6Yniffi8YrsArrayC",
"text" : "YrsArray"
}
],
"identifier" : "doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi\/FfiConverterTypeYrsArray_lift(_:)",
"kind" : "symbol",
"role" : "symbol",
"title" : "FfiConverterTypeYrsArray_lift(_:)",
"type" : "topic",
"url" : "\/documentation\/yniffi\/fficonvertertypeyrsarray_lift(_:)"
},
"doc://com.github.y-crdt.YSwift/documentation/Yniffi/YrsArray": {
"abstract" : [

],
"fragments" : [
{
"kind" : "keyword",
"text" : "class"
},
{
"kind" : "text",
"text" : " "
},
{
"kind" : "identifier",
"text" : "YrsArray"
}
],
"identifier" : "doc:\/\/com.github.y-crdt.YSwift\/documentation\/Yniffi\/YrsArray",
"kind" : "symbol",
"navigatorTitle" : [
{
"kind" : "identifier",
"text" : "YrsArray"
}
],
"role" : "symbol",
"title" : "YrsArray",
"type" : "topic",
"url" : "\/documentation\/yniffi\/yrsarray"
}
}
}
Loading

0 comments on commit a260487

Please sign in to comment.