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

cmdlet documentation #47

Open
timoline opened this issue Mar 17, 2019 · 7 comments
Open

cmdlet documentation #47

timoline opened this issue Mar 17, 2019 · 7 comments
Assignees
Labels
Help Wanted We need help from the community to get the fixed or added

Comments

@timoline
Copy link

Cmdlet documentation should be very easy now to add

https://github.com/PowerShell/platyPS

@raandree raandree added the Help Wanted We need help from the community to get the fixed or added label Apr 2, 2019
@raandree
Copy link
Owner

raandree commented Apr 2, 2019

There is a lack of time on my side to cover this. It would be great if the community could step in here.

@Sup3rlativ3
Copy link

I would be willing to help here. I don't know C but I've had a look at some of the files such as Add-NTFSAccess and can follow along.

  • Are there some guidlines you would like followed or just the standard PS format?
  • Do you want the help just in the cmdlet or would you like a wiki here/readthedocs?
  • Do you have any other points/requests for this?

@raandree
Copy link
Owner

@Sup3rlativ3, thanks for any time you can spare on this!

@nyanhp has updated the help for AutomatedLab with "Read the Docs" which moves the help to a completely new level. I was not following this change but from what I have understand

  • The help is just written in markdown
  • The markdown files are published somehow using ReadTheDocs
  • When building AL, we use PlatyPS to create "-help.xml" files

This seems to be the best way dealing with help.

@nyanhp, would you still do the same?

@aafksab
Copy link

aafksab commented Aug 7, 2019

I just submitted a pull request for the auto-generated markup files in ./docs
They are missing some data, and I will update as I learn more about this module

@Sup3rlativ3
Copy link

@nyanhp Can you please confirm if the above process by @raandree is still the preferred method?

@Sup3rlativ3
Copy link

Any more info on this guys?

@Sup3rlativ3
Copy link

I've noticed that my PR was committed!

Was everything as you liked or is there something I can adjust?

I'd also like to give permission to the RTD page to @raandree if that's possible or would you like to change the setup to point to another setup you create?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Help Wanted We need help from the community to get the fixed or added
Projects
None yet
Development

No branches or pull requests

4 participants