Xamarin-macios: Publish mmp-errors.md and generator-errors.md documentation
We only move mtouch-errors to the documentation and therefore publish them to the world.
It seems we don't have a public page for the mmp ones.
Also as a side note: when we do we'll need the VS/VSMac integration.
VincentDondain
All 14 comments
That should likely be an issue in the docs repo.
c.c. @bradumbaugh for the locations
spouliot
on 16 Mar 2018
@spouliot @VincentDondain I think we should put them under "Troubleshooting," as that's where they are in the iOS repo. Will get set up for that and let you know, since it's a new item in the TOC.
bradumbaugh
on 16 Mar 2018
@spouliot @VincentDondain @chamons
- Created a branch in the docs repo for this work: brumbaug-mac-troubleshooting
- Took the current version of mmp-errors.md and put it on this branch; also updated anchor formatting for docs.microsoft.com
- Didn't update the bug tracking information, because I'm unclear if I can safely edit those messages or not
Feel free to make any changes you need... will hold off on merging until you've had a chance to edit, etc.
bradumbaugh
on 20 Mar 2018
https://github.com/MicrosoftDocs/xamarin-docs-pr/tree/brumbaug-mac-troubleshooting is a dead link for me (permissions?)
chamons
on 21 Mar 2018
@bradumbaugh it's not ideal since you took master (and not the released d15-6) but it's better than not having it published :) Let's merge this one and we'll start updating it with 15.8 (which will be an update from master)
spouliot
on 26 Mar 2018
@spouliot It's easy for me to take a different one - happy to grab the 15.6 version and re-apply the changes that I made.
bradumbaugh
on 26 Mar 2018
Put together a PR for this work.
bradumbaugh
on 28 Mar 2018
@VincentDondain
- This doc has been published: https://docs.microsoft.com/en-us/xamarin/mac/troubleshooting/mmp-errors.
- Closed with https://github.com/MicrosoftDocs/xamarin-docs-pr/pull/137
bradumbaugh
on 3 Apr 2018
@bradumbaugh what about the generator errors: https://github.com/xamarin/xamarin-macios/blob/master/docs/website/generator-errors.md?
VincentDondain
on 3 Apr 2018
@VincentDondain Sorry, missed this. Are these Mac-specific or iOS-specific? Or relevant to both?
bradumbaugh
on 3 Apr 2018
@bradumbaugh relevant to both (:
VincentDondain
on 3 Apr 2018
Hi,
@conceptdev This is still a problem we're facing today and we really should publish the generator errors (there's an argument to be made that we should split them into individual issues first).
In https://github.com/xamarin/xamarin-macios/issues/5260 the customer got a BI1014 issue and no way to access the extra bit of documentation we provide in that document: https://github.com/xamarin/xamarin-macios/blob/master/docs/website/generator-errors.md#bi1014-unsupported-type-for-fields--for-. In addiction we cannot have IDE support for BI errors (where we redirect to the doc when double clicking on the issue) if we don't publish the document first.
VincentDondain
on 12 Dec 2018
@VincentDondain it would be great to have all the error messages published, like the c# errors are (source). Splitting them up would help enormously with discoverability/navigation, and make direct links easier/more reliable.
conceptdev
on 12 Dec 2018
@conceptdev it's still the plan, ref: https://github.com/xamarin/xamarin-macios/issues/3570 but we have not gotten to it yet
It seems like starting the "new" binding errors that way could be a stepping stone before converting the existing ones
spouliot
on 12 Dec 2018
Related issues
chamons
路
3Comments
whitneyschmidt
路
3Comments
jzeferino
路
3Comments
rolfbjarne
路
4Comments
sharmashiv
路
4Comments
Most helpful comment
@spouliot @VincentDondain I think we should put them under "Troubleshooting," as that's where they are in the iOS repo. Will get set up for that and let you know, since it's a new item in the TOC.