Aligned the inline docs in dids/src/index.ts with the contents of did…

[pawartur]

Description

Updated the inline docs to include the examples and security considerations that were previously only in README.

The contents of the inline docs will also be used for the automated generation of the https://did.js.org/docs/api/modules/dids page.

How Has This Been Tested?

Describe the tests that you ran to verify your changes. Provide instructions for reproduction.

• [X] Manually generated and reviewed the docs

Definition of Done

Before submitting this PR, please make sure:

• [X] The work addresses the description and outcomes in the issue
• [X] My code follows conventions, is well commented, and easy to understand
• [X] My code builds and tests pass without any errors or warnings
• [X] I have tagged the relevant reviewers
• [X] I have updated the READMEs of affected packages
• [X] I have made corresponding changes to the documentation
• [X] The changes have been communicated to interested parties

[linear[bot]]

APPS-676 Make overviews of `did` and `did-session` packages consistent on did.js.org

### Description Originated from @oed 's remark ([https://discord.com/channels/484729862368526356/880367090371035206/1012696591045509160](https://discord.com/channels/484729862368526356/880367090371035206/1012696591045509160)) : > **@artur.wdowiarski🔸** do you know why the readme of the dids pkg is not being populated in the API docs? > > Info from readme: [https://did.js.org/docs/api/modules/did_session](https://did.js.org/docs/api/modules/did_session) > > No info from readme: [https://did.js.org/docs/api/modules/dids](https://did.js.org/docs/api/modules/dids) #

[pawartur]

Thanks, @PaulLeCam !

Yes, the contents was copied from dids' README. One notable difference is that I removed the link to online docs from index.ts, as we will be generating the same online docs from this file in the first place.

The wrong link in website/docs/api/modules/dids.md that you commented on was there, because I didn't rebuild the docs after removing the link from the index.ts file.

I hope all is good now.