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

Position of Parameters in documentation of a function (handling of @remarks) #451

Closed
petrvilim opened this issue Jul 24, 2023 · 2 comments
Closed

Comments

@petrvilim
Copy link

Thank you for your work!

Here's documentation for a class method generated by typedoc without the markdown plugin. Notice that Parameters and Returns are at the top of the page, just after the brief description of the function and before Remarks:

image

With typedoc-plugin-markdown, Parameters are at the bottom, regardless of the @remarks tag:

image

Is there a way to move Parameters up? Am I missing something obvious?

I'm using TypeDoc 0.24.8 and typedoc-plugin-markdown 3.15.3. The screenshot above is from docusaurus 2.3.1 with docusaurus-plugin-typedoc 0.19.2.

The documentation in the source file looks like this:

  /** 
  * Creates an integer expression for the end of an interval variable.
  * 
  * @remarks
  * 
  * If the interval is absent then the resulting expression is also absent.
  * 
  * @example
  * 
  * In the following example we constraint interval variable `y` to start after end of `y` with a delay at least 10. In addition we constrain length of `x` to be less or equal than length of `y`.
  * 
  * ```ts
  * let model = new CP.Model;
  * let x = model.intervalVar({ name: "x", ... });
  * let y = model.intervalVar({ name: "y", ... });
  * model.constraint(model.endOf(x).plus(10).le(model.startOf(y)));
  * model.constraint(model.lengthOf(x).le(model.lengthOf(y)));
  * ```
  * 
  * When `x` or `y` is _absent_ then value of both constraints above is _absent_ and therefore they are satisfied.
  * 
  * @see {@link IntervalVar.end} is equivalent function on {@link IntervalVar}.
  * @see Function {@link Model.endOr} is a similar function that replaces value _absent_ by a constant.
  *  */
  endOf(interval: IntervalVar): IntExpr { 

Thank you!

@tgreyuk
Copy link
Member

tgreyuk commented Jul 24, 2023

Thanks - have updated to follow pattern of the html theme. Available in typedoc-plugin-markdown@3.15.4.

@petrvilim
Copy link
Author

Thank you, that was really fast! It works like a charm.

@tgreyuk tgreyuk closed this as completed Jul 25, 2023
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

No branches or pull requests

2 participants