Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SEO Review #15

Open
5 of 6 tasks
kempsterrrr opened this issue Aug 16, 2024 · 15 comments
Open
5 of 6 tasks

SEO Review #15

kempsterrrr opened this issue Aug 16, 2024 · 15 comments
Assignees

Comments

@kempsterrrr
Copy link
Member

kempsterrrr commented Aug 16, 2024

WIP TODOs:

  • add sitemap: next docs, video guide
  • Only /, /tracks & /fundamentals are being indexed when crawled. all pages need to be indexed. I'm unsure what is causing this yet but am asking an SEO friend
  • SEO title generation does not include the site name. For the Arweave 101 track page, the title in the Search results should be Arweave 101: Building Apps on Arweave | Developer DAO Academy whereas this version, it is Arweave 101: Building Apps on Arweave - | Developer DAO Academy is missing from the end. The inclusion of | Developer DAO Academy should be programmatic and added to all pages automatically.
  • ensure URLs are using - "dashes" in between words not _ underscores, example for CLI Lesson using underscores - https://academy-t3-app-router.vercel.app/fundamentals/cli_lesson
  • update favicon to use latest logo from the DD brand guide
  • 404 page isn't working

** questions:**

  1. Why are we rendering pages like tracks and fundamentals on the client? Could these be server-rendered or statically generated, as this would be helpful with SEO, Speed and indexing?
@kempsterrrr
Copy link
Member Author

OK, it looks like the issue in the second point about pages being rendered is that we're rendering them on the client. The same issue is present on the production academy site. If we can solve that on this new version with SSG/SSR rendering those pages, that would be great for SEO/UX/Performance, etc.

@kempsterrrr
Copy link
Member Author

@Markkos89 sitemap is looking niiiiiiiice, good work. Quick fix needed on this, there are double slashes appearing in some of the URLs in the sitemap.xml file here

image

@Markkos89
Copy link
Collaborator

@Markkos89 sitemap is looking niiiiiiiice, good work. Quick fix needed on this, there are double slashes appearing in some of the URLs in the sitemap.xml file here

image

Alright, fixed it on #17

💪

@kempsterrrr
Copy link
Member Author

amazing shipping @Markkos89 letsssgoooo

@Markkos89
Copy link
Collaborator

amazing shipping @Markkos89 letsssgoooo

Thanks kemps! 🙌

Can you check again if every page is being indexed now? 🤔 🙏

Thanks in advance!

@Markkos89
Copy link
Collaborator

@kempsterrrr quick question, just to be sure, this is the desired favicon? 🤔

image

in case is not, can you please let me know which one?

@kempsterrrr
Copy link
Member Author

amazing shipping @Markkos89 letsssgoooo

Thanks kemps! 🙌

Can you check again if every page is being indexed now? 🤔 🙏

Thanks in advance!

I think this is working ok, tools seem to be recognising the sitemap however as the pages are rendered with JavaScript the tool isn't crawling them because I need the very expensive paid version to do that. I think this is fine to ship as is and will make a note to look into it later this week when I have a little more time to see if can figure it out.,

in case is not, can you please let me know which one?

these are the correct ones yes, although use the square logo for the favicon as they show as squares in the browser.

@kempsterrrr
Copy link
Member Author

@Markkos89 I noticed the 404 page wasn't working so added that as a todo item on here.

How are you getting on with the other items? What else do you still need from me?

@Markkos89
Copy link
Collaborator

How are you getting on with the other items? What else do you still need from me?

I will write down the status of each remaining list item below @kempsterrrr
Just wondering if we are putting a lot on this SEO stuff when it can be done having the t3-app-router version online.


SEO TODOs status:

  • Only /, /tracks & /fundamentals are being indexed when crawled. all pages need to be indexed. I'm unsure what is causing this yet but am asking an SEO friend

Regarding indexing I'm waiting an update from you.
Last thing was that the app tool is very expensive to check other pages.
How are you testing this? If you can tell me what to do I can do the testing just for the sake of moving forward.

This is solved with the latest update of dynamic segment (dynamic routes)

  • ensure URLs are using - "dashes" in between words not _ underscores, example for CLI Lesson using underscores - https://academy-t3-app-router.vercel.app/fundamentals/cli_lesson

This is something I leaving for later because it's something really small to do but if I change the database data will affect our production environment from academy-turbo.

i will add it.

@kempsterrrr
Copy link
Member Author

kempsterrrr commented Sep 16, 2024

Nice work!

All I'm doing to check for the first point is running it through this tool which scrapes the site to check for SEO errors.

Ideally we want to it pick up all the pages in the site. If the changes moved us away from client rendering they should show up in the crawl report. Only need paid version to crawl for client rendered pages which we're hoping to avoid.

Ticked of the second one

Makes sense re ULR changes, thanks for letting me know.

Sounds good re 404

@kempsterrrr
Copy link
Member Author

In support of getting app router version live asap, these bits (minus the dashes vs underscores) get us there.

@Markkos89
Copy link
Collaborator

@kempsterrrr FYI I still have to create the content creators/authors/contributors registries in the database because it's going to be fetched dinamically. Can you help me gather all the information for all the contributors?

we have some info in the contributors.ts file but maybe there is something left there so if you could gather all the info from the .mdx files that would be awesome mate 🙌

The goal is to populate this table:

image

I left some notes in the code of where is going to be used

@Markkos89
Copy link
Collaborator

@kempsterrrr PR #21 is merged.
Now the sitemap.ts will generate the sitemap.xml with this project domain URL https://academy-t3-app-router.vercel.app/. screenshot:
image
with this change deployed now we have to check if the pages are being indexed, etc (item number 2 from the TODO list)
I will take care of that.

The 404 page was added. I ticked the 404 page item from the list.
The only item remaining is the one related to the dashes on the Lesson path. We are good.

@kempsterrrr
Copy link
Member Author

kempsterrrr commented Sep 17, 2024

Excellent work, @Markkos89 ! I confirmed the pages are being crawled now 👏👏

Running the test did highlight a few other issues we need to work on for SEO, but they shouldn't be a blocker for getting this new version live, as these issues exist on the current site. I'll make a note to open another issue so we can track these as well; straightforward fixes could be excellent first issues for folks or easily added to another future PR.

@wolovim, can you help gather the info for content creators, please?

@Markkos89
Copy link
Collaborator

Excellent work, @Markkos89 ! I confirmed the pages are being crawled now 👏👏

Awesome!! Thanks @kempsterrrr

@wolovim, can you help gather the info for content creators, please?

@kempsterrrr @wolovim I will be working on this tomorrow 💪

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants