Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add preview and related reads components #673

Merged
merged 3 commits into from
Oct 8, 2021
Merged

add preview and related reads components #673

merged 3 commits into from
Oct 8, 2021

Conversation

swyxio
Copy link
Contributor

@swyxio swyxio commented Oct 8, 2021

Special Preview link

import a page and add the new <preview> tag:

<!-- prettier-ignore -->
import * as WorkflowTask from "../content/what-is-a-workflow-task.md"

blah blah blah this is markdown with a <preview page={WorkflowTask}>MAGIC PREVIEW</preview> link blah blah.

https://deploy-preview-673--mystifying-fermi-1bc096.netlify.app/docs/concepts/workflows#task-timeout

image

Related Read List

swap out <RelatedReadList> with RelatedReadContainer and RelatedReadItem.

<!-- prettier-ignore -->
import * as WWID from './what-is-a-workflow-id.md'

<RelatedReadContainer>
  <RelatedReadItem page={WWID} />
</RelatedReadContainer>

https://deploy-preview-673--mystifying-fermi-1bc096.netlify.app/docs/content/how-to-set-startworkflowoptions-in-go/#id

image

If there are multiple items, the container auto switches to a bulleted list.
By default, RelatedReadItem uses the title of the page as its link text. to customize it, give it a child:

<RelatedReadContainer>
  <RelatedReadItem page={Bar}>hi Cully</RelatedReadItem>
  <RelatedReadItem page={Foo}>hi Dail</RelatedReadItem>
</RelatedReadContainer>

Notes to reviewers

see diffs for what to take out and what to put in. mind your imports and your closing tags. it doesnt really matter what you name the imported MDX files, just make sure you use import * as Foo from '...' instead of import Foo from '...'.

Comment on lines -43 to +48
<RelatedReadList
readlist={[
["What is a Workflow Id?","/docs/content/what-is-a-workflow-id","explanation"],
]}
/>
<!-- prettier-ignore -->
import * as WWID from './what-is-a-workflow-id.md'

<RelatedReadContainer>
<RelatedReadItem page={WWID} />
</RelatedReadContainer>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

example conversion of RelatedReadList

Comment on lines -129 to +134
- **Performance**: Keep in mind that all parameters and return values are recorded in the [Workflow Execution Event History](/docs/content/what-is-an-event-history).
A large Workflow Execution Event History can adversely impact the performance of your Workflow Executions, as the entire Event History is transferred to Worker Processes with every [Workflow Task](/docs/content/what-is-a-workflow-task).
<!-- prettier-ignore -->
import * as EventHistory from "./what-is-an-event-history.md"
import * as WFTask from "./what-is-a-workflow-task.md"

- **Performance**: Keep in mind that all parameters and return values are recorded in the <preview page={EventHistory}>Workflow Execution Event History</preview>.
A large Workflow Execution Event History can adversely impact the performance of your Workflow Executions, as the entire Event History is transferred to Worker Processes with every <preview page={WFTask}>Workflow Task</preview>.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

example conversion of <preview> component

Comment on lines -122 to +125
- **Description**: This is the maximum amount of time that the Server will wait for the Worker to start processing a [Workflow Task](/docs/content/what-is-a-workflow-task) after the Task has been pulled from the Task Queue.
<!-- prettier-ignore -->
import * as WorkflowTask from "../content/what-is-a-workflow-task.md"

- **Description**: This is the maximum amount of time that the Server will wait for the Worker to start processing a <preview page={WorkflowTask}>Workflow Task</preview> after the Task has been pulled from the Task Queue.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

example conversion of <preview> component

@swyxio swyxio changed the title add preview component add preview and related reads components Oct 8, 2021
@flossypurse flossypurse merged commit f17adcb into master Oct 8, 2021
@flossypurse flossypurse deleted the addPreview branch October 8, 2021 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants