Change Airbyte Spec doc links to permalinks.

[avaidyanatha]

Main Changes

• A lot of line references are out of sync since we didn't use permalinks, this switches all old links to reference the correct lines and makes them use permalinks.

[michel-tricot]

does it mean we need to update the blob id everytime we change these files to ensure we have the latest version?

[cgardens]

does it mean we need to update the blob id everytime we change these files to ensure we have the latest version?

We have to update these links every time we make changes regardless of this change. The problem we are trying to solve is we have links that refer to line numbers but then over time the line numbers drift as the files change but the links aren't updated. So you pretty much have no guarantee that any of these links are ever right.

The new approach is to at least give a high guarantee that, for eternity, my link will always go to the right place. If I update the underlying doc though I do need to update the link if i want to see the new content.