Update Graphql API docs for permalink path
This is a follow-up of [previous MR](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/186829), where the suggestion was made to add a section/heading about 'Tree permalinks.' This will help improve navigation and clarity in the documentation.
issue