Initial attempt at order error enum docs

[edd]

This PR adds some documentation to the order error proto in order to improve the generated documentation.

Closes #2002

[peterbarrow]

ORDER_ERROR_TIME_FAILURE // Unable to get Vega (blockchain) time
ORDER_ERROR_REMOVAL_FAILURE // Failed to remove an order from the book
Amended instead of Ammended
ORDER_ERROR_AMEND_FAILURE // Amend failure because amend details do not match original order
ORDER_ERROR_NOT_FOUND // Order not found in the order book or in order store

[peterbarrow]

ORDER_ERROR_EDIT_NOT_ALLOWED // This occurs when the client tries to amend a field that is not amendable (like order type, creation time etc)

[cdm]

Woo! You're doing some work for me here - thank you. I'm going to do a full review of the comments etc WRT auto-generated docs in the coming days. REF #1933 #1934 (and somewhat but its already good #1932)

[cdm]

Also specifically this task is related https://github.com/vegaprotocol/docs/issues/77

[edd]

Nice! Be aware that it takes longer than you think to work out the reasons why some error codes are triggered - I thought I could bash this out in 20 minutes, but it's probably been an hour + 20 minutes of Pete's time, and I'm not even sure that they're right. But they're definitely better than nothing.

[edd]

Thanks @peterbarrow, I've merged all yours in to the PR. I still have to regenerate the gubbins so I'll mark this as draft until I have.

[vega-ci-bot]

system-tests failed.

=== Test summary ===
../../grpcTesting/accounts/accountsTests.py .                            [100%]
../../grpcTesting/devnet/sanityTests.py ......                           [100%]
../../grpcTesting/governance/newAssetTests.py .                          [100%]
../../grpcTesting/governance/newMarketGovTests.py EEEEEEEEEEEEEEEEEEEEEx [ 47%]
EEEEEEEEEEEEEEEEEEEEEEEE                                                 [100%]
 ERROR at setup of testVoteNDecline 
 ERROR at setup of testVoteYEnactedFail 
 ERROR at setup of testVoteYNProposalDraw 
 ERROR at setup of testVoteYYNProposalPass 
 ERROR at setup of testNewMarketRejectNoStake 
 ERROR at setup of testNewMarketValidProposal 
 ERROR at setup of testGetAllProposals 
 ERROR at setup of testGetAllOfTheProposals[6] 
 ERROR at setup of testGetNewMarketProposals[6] 
 ERROR at setup of testGetAllOfTheProposals[2] 
 ERROR at setup of testGetNewMarketProposals[2] 
 ERROR at setup of testGetAllOfTheProposals[5] 
 ERROR at setup of testGetNewMarketProposals[5] 
 ERROR at setup of testGetAllOfTheProposals[4] 
 ERROR at setup of testGetNewMarketProposals[4] 
 ERROR at setup of testGetAllOfTheProposals[3] 
 ERROR at setup of testGetNewMarketProposals[3] 
 ERROR at setup of testGetProposalsByParty 
 ERROR at setup of testGetRejectedProposalsByParty 
 ERROR at setup of testGetOpenProposalsByParty 
 ERROR at setup of testGetVotesByParty 
 ERROR at setup of testNewMarketOpenSingleTok 
 ERROR at setup of testVoteYSmallHolder 
 ERROR at setup of testVoteYMediumNSmallHolder 
 ERROR at setup of testVoteTopUpSmallDuringVote 
 ERROR at setup of testVoteYNNoFundsProposal 
 ERROR at setup of testNewMarketInvalidParty 
 ERROR at setup of testInvalidEnactTime 
 ERROR at setup of testVoteYOwnOpenProposal 
 ERROR at setup of testVoteYOpenProposal 
 ERROR at setup of testVoteNOpenProposal 
 ERROR at setup of testVoteNoStakeOpenProposal 
 ERROR at setup of testVoteNoStakeAddFunds 
 ERROR at setup of testVoteRejectProposal 
 ERROR at setup of testVotePassedProposal 
 ERROR at setup of testVoteBothYNOpen 
 ERROR at setup of testVoteTwiceYSameUser 
 ERROR at setup of testVoteInvalidProposalID 
 ERROR at setup of testVoteEnactedMarket 
 ERROR at setup of testVoteDeclinedMarket 
 ERROR at setup of testVoteYTaintedKey 
 ERROR at setup of testNewMarketClosedProposal 
 ERROR at setup of testSubmitEnactedGTCOrder 
 ERROR at setup of testSubmitUnEnactedMarketGTCOrder 
 ERROR at setup of testFiftyYesVoteProposal 
../../grpcTesting/governance/newMarketTradesTests.py EEEEEEEEEEEE        [100%]
 ERROR at setup of testTradeGTCToGTC 
 ERROR at setup of testTradeGTTToGTT 
 ERROR at setup of testTradeGTCToIOC 
 ERROR at setup of testTradeGTCToFOK 
 ERROR at setup of testTradesByParty 
 ERROR at setup of testPositionsByParty 
 ERROR at setup of testCloseOutTraderBuyOrders 
 ERROR at setup of testCloseOutTraderSellOrders 
 ERROR at setup of testTradesByMarket 
 ERROR at setup of testTradeGTTToIOC 
 ERROR at setup of testTradeGTTToFOK 
 ERROR at setup of testNoTradeGTCToStopped 
../../grpcTesting/margins/marginsTests.py .                              [100%]
../../grpcTesting/markets/marketsTests.py ..............                 [100%]
../../grpcTesting/orders/amendOrdersTests.py ........................... [ 87%]
....                                                                     [100%]
../../grpcTesting/orders/cancelOrdersTests.py .......................    [100%]
../../grpcTesting/orders/generalOrdersTests.py .F...                     [100%]
 testActiveOrdersByMarket 
../../grpcTesting/orders/limitOrdersTests.py ...........                 [100%]
../../grpcTesting/orders/marketOrdersTests.py ........                   [100%]
../../grpcTesting/orders/mixedOrdersTests.py .....................       [100%]
../../grpcTesting/orders/negativeOrdersTests.py ........................ [ 57%]
....x.........s...                                                       [100%]
../../grpcTesting/parallel/submitParallelOrdersTests.py ........         [100%]
../../grpcTesting/parties/partiesTests.py ..                             [100%]
../../grpcTesting/trading/positionsTests.py ..                           [100%]
../../grpcTesting/trading/tradesTests.py ............                    [100%]
../../grpcTesting/wallet/walletTests.py ................................ [ 76%]
..........                                                               [100%]
../../rest/orders/negativeOrdersTests.py .                               [100%]