CC@pablogsal

Should this live in the code? I think this should live in the docs and we should just print a link for it. This documentation should probably live withsys.remote_exec. We don't want to duplicate this everywhere that usessys.remote_exec(). I don't think we should have this big chunk of clearly documentation in the code itself.

Should this live in the code? I think this should live in the docs and we should just print a link for it.

I think so. We want to provide actionable output to the users right where the error happens and not just in the docs. We could put it somewhere in the docs and drop a link there though although I think that is slight worse experience. But I don't feel very strongly

I think this is too much text living in the code - especially with multiple copies. If we have a third library that utilizessys.remote_exec, are we going to replicate the whole text again? Under the hood, this is an issue withsys.remote_exec, not the modules that use it. For users that usesys.remote_exec directly, they'll still be confused.

I suggest that we put a link to the docs in thePermissionError itself as a message, so it would be simply shown in the traceback.

I think this is too much text living in the code - especially with multiple copies. If we have a third library that utilizessys.remote_exec, are we going to replicate the whole text again? Under the hood, this is an issue withsys.remote_exec, not the modules that use it. For users that usesys.remote_exec directly, they'll still be confused.

Maybe, but one of these cases is not even usingremote_exec so is not true that this is an issue withremote_exec. Also,remote_exec is low level so it doesn't need to be prescriptive. Indeed, for pdf is an implementation detail so it doesn't make sense to redirect users to the docs ofremote_exec

, so it would be simply shown in the traceback.

These are CLI tools, we shouldn't show traceback here but a nice friendly error message

We can show a message instead of traceback I have no problem with that. I really don't think we should have 50 lines of documentation pasted all over our code base. The detailed explanation should definitely live in the documentation somewhere. We should say something like "You don't have the permission to (retrieve data from?attach to?) another proces, for detailed information, seehttps://docs.python.org/...". For Unix users, that would directly translate to - try it withsudo and that's not too bad.

We can show a message instead of traceback I have no problem with that. I really don't think we should have 50 lines of documentation pasted all over our code base. The detailed explanation should definitely live in the documentation somewhere. We should say something like "You don't have the permission to (retrieve data from?attach to?) another proces, for detailed information, seehttps://docs.python.org/...". For Unix users, that would directly translate to - try it withsudo and that's not too bad.

Alright let's out this in the docs somewhere thst makes sense and lets link to that from the error message. Would that work for you?

Yes, that works for me.