Developers Forum for XinFin XDC Network

Arturo Cantera Carrasco
Arturo Cantera Carrasco

Posted on • Updated on

[Informative] XDC Docs Update

Hi Team,

I hope this message finds you well.

I’ve spent some time reviewing our current documentation, specifically:

Frankly, the current state of our documentation gives an impression of an old or abandoned blockchain. This is a significant concern, as our documentation is often the first touchpoint for new developers and users.

To get a sense of what top-tier documentation looks like, I explored the documentation of some of our competitors:

These platforms showcase up-to-date information, an easy-to-explore interface, and valuable resources that enhance user experience.

To be in the top 1, we must start taking care of the basics. Updating our documentation to match or exceed these standards is a critical step.

Let’s discuss and plan the necessary updates to make our documentation not only current but also highly user-friendly and informative.

Best regards.

Discussion (9)

Collapse
0xbeny profile image
Beny

This was one of the topics earlier this year.
We agreed to have only docs.xdc.community as the main documentation website and shutting down the others due to 1st. the maintaining 3 at the same time is heavy-lifting. 2nd. as described on the article "the first touchpoint for new developers and users".

Still I'd see more enhancements/upgrades should be done on this website.

Collapse
sean_ profile image
Sean

I completely agree with this. There is no point in having multiple documentation pages like there is no point in having multiple explorers with almost similar interface. Maintaining multiple explorer consumes time and money. @blocksscanio team has made some really good and really impressive updates to their explorer. All we need is to focus on a single top notch explorer instead of diverting our energy on maintaining multiple explorers.

Collapse
xcantera profile image
Arturo Cantera Carrasco Author

Etherscan.io integration with XDC is almost completed. They are indexing all the blockchain data. We will use xdcscan.com domain as the new explorer.

Thread Thread
sean_ profile image
Sean

Now, that's really a fantastic news! Great work!

Collapse
xcantera profile image
Arturo Cantera Carrasco Author

Totally agree. We should remove the other ones, and just use one.

I think maybe community and team can help having an updated Docs.

We can do a bounty system to improve all of that.

Collapse
akhekade profile image
Atul Khekade

Lets get one really top of the notch documentation. BTW, I dont know if people behind docs.xdc.community are even active anymore.

Collapse
sean_ profile image
Sean

The documentation is a part of discussion during every weekly developer's call. Not saying that it's perfect but @anilchinchawale, @lance, @0xbeny, @s4njk4n and many others have been constantly contributing and updating the content on the documentation page. But UI, I believe can definitely be worked upon for a better aesthetics and an even better user experience.

Collapse
0xbeny profile image
Beny

Def.. There are a few community members who are working on enhancements. it's on our track.

Collapse
anilchinchawale profile image
AnilChinchawale

Let's connect to identify and improve the documentation to be as helpful as possible for developers.