search

PowerShellOrg / DSC

DSC Tools and Documentation
MIT License
299 stars 108 forks source link

Convert .docx docs to markdown #38

Closed ArtWDrahn closed 10 years ago

ArtWDrahn commented 10 years ago

When downloading the repro I've found I've been unable to open the docx files (cNetworking, cWebAdministration) and am unable to recover them. Its been my experience that github doesn't handle this type of files well. Switching to md would allow github to parse the file in the browser, and allow us to make modifications to the documentation that are well documented surgical changes.

lholman commented 10 years ago

Happy to pick this up if there's an agreement it's of value?

smurawski commented 10 years ago

@lholman That would be awesome!

brettski commented 10 years ago

I am willing to lend a hand in reformatting the documents as well. Not to duplicate efforts between us, I will start with TechNetDocumentation-cNetworking.docx. If this has been started on, I'll pick another.

brettski commented 10 years ago

Well that is very interesting, the file can't be opened from a fork. I download the repo as zip, and that version is corrupt as well. This will make things a bit more difficult to transfer...

smurawski commented 10 years ago

It may be corrupted due to some file encoding shenanigans. I'd grab the technet zip and work from there. On Aug 7, 2014 9:26 PM, "Brett Slaski" notifications@github.com wrote:

Well that is very interesting, the file can't be opened from a fork. I download the repo as zip, and that version is corrupt as well. This will make things a bit more difficult to transfer...

— Reply to this email directly or view it on GitHub https://github.com/PowerShellOrg/DSC/issues/38#issuecomment-51556625.

brettski commented 10 years ago

Is this correct? http://gallery.technet.microsoft.com/scriptcenter/DSC-Resource-Kit-All-c449312d

smurawski commented 10 years ago

I believe so. Our copies of the resources are older though and need catching up. On Aug 7, 2014 9:39 PM, "Brett Slaski" notifications@github.com wrote:

Is this correct? http://gallery.technet.microsoft.com/scriptcenter/DSC-Resource-Kit-All-c449312d

— Reply to this email directly or view it on GitHub https://github.com/PowerShellOrg/DSC/issues/38#issuecomment-51557248.

brettski commented 10 years ago

Cannot find originals for:

So they cannot be converted to markdown.

dlwyatt commented 10 years ago

Documentation-cComputer.docx hasn't been corrupted; you should be able to open it from the latest commits in this repo.

The original, uncorrupted version of TechNetDocumentation-cHyperV.docx can be found in the history here on GitHub: https://github.com/PowerShellOrg/DSC/raw/9ed35d6fa88b869f16223269e3715ad5e6408aa8/Resources/cHyper-V/TechNetDocumentation-cHyperV.docx

ArtWDrahn commented 10 years ago

I'll grab the HyperV one.

brettski commented 10 years ago

I am unable to open Documentation-cComputer.docx from the downloaded zip or my fork. If you have a good copy of it, please send it to me.

ArtWDrahn commented 10 years ago

@brettski skimmed through the history like @dlwyatt did (didn't know this would work). And found a good copy here: https://github.com/PowerShellOrg/DSC/blob/9ed35d6fa88b869f16223269e3715ad5e6408aa8/Resources/cComputerManagement/Documentation-cComputer.docx

dlwyatt commented 10 years ago

On @ArtWDrahn 's link, click the Raw button to download the docx file to your PC.

ArtWDrahn commented 10 years ago

Going to close this one as everything got forked into its own projects and we should probably be filing any issues there.