Closed brianlagunas closed 7 years ago
hi @brianlagunas
I'd like to help :smile:
Do we have a sample project? It'll be easier to have a web that describes Prism using sample codes of a small app.
Hey @eriawan
We got several samples for each platform on the Prism organization:
There's also quite some effort done for documentation (mainly on WPF, but XF is coming along as well).
I don't think it's necessary to duplicate this effort, but mentioning (showing) how easy it is to get started might be a good sales point indeed.
@brianlagunas Are you thinking of using a static site generator like Jekyll?
I would like to help if I can. Though, I am not very familiar with the github workflow.
Sure. That would work.
I have created a website for this project, I hope you like it. Prism helps me a lot and I wanted to help it.
@brianlagunas now that we have prismlibrary.girhub.io, could I just copy and paste some of the MD files that we already have? we could adjust the overall look later, as we should have content soon based on existing documentation that we have now.
We don't want too much duplicate content to maintain, so I wouldn't just copy/paste our docs. Either we maintain the docs here and keep the site minimal (doc wise), or we move them all.
@brianlagunas IMHO it's better to move them all to the github.io website. What do you think?
Yeah, I am okay with moving docs to GitHub website. Probably easier to find there.
@brianlagunas @bartlannoeye OK, so could I copy and paste the Prismlibrary documentation to the github.io site? I'll copy and paste all of them first, then we can safely delete the MD docs on the existing Prismlibrary, Or we should ease the migration by simply say that it's moved to the github.io website (after the copy and paste is done).
Don't delete the docs from the current repo. Let's get the website up first and then I will remove the docs when everything is in place.
ok, thanks for your quick reply, @brianlagunas :)
I am going to clone both the repo and create a new branch on the github.io page now.
What do you think about using read-the-docs?Used by other Microsoft .NET projects (aspnet and EF two examples). It renders documentation from Markdown-ish code and pulls the code from repo so I suggest creating Prism.Documentation and move the docs there. Here is how EF looks and the source from which it's generated.
Doesn't look like a bad option. When I get some time I'll look more into this.
If you still need a website, please tell me. I have an agency in Brazil and I'd love to help! Check my portfolio: www.riandesign.com.br
Would love a website. I'll never get around to building one :)
Ok! Would you install in a domain like prism.com or where? What would be the content of this site? Please, tell me how you'd like it, so I create a mockup to show you.
I do have the http://prismlibrary.com domain. I think ideally it would be good if the website was placed in this repo: https://github.com/PrismLibrary/prismlibrary.github.io
The website should be pretty simply. I haven't put much time into thinking about what content is should have, but it looks like it would be close to the https://angularjs.org/ site. Simple website that provides the GitHub link, the Documentation link. A section for Learn where I can place videos (youtube) and links to my pluralsight courses. A way to link to various blogs posts on my blog, or even other peoples blogs. Point people to the slack channel, report bugs, follow me on twitter, and stuff like that. I would even really like it to be localized to Japanese. I can do the text translation, but the mechanism needs to be on the site to change languages.
Those are my initial thoughts. Like I said, I really have thought about it in much detail yet, so I am sure I am missing something :)
@brianlagunas cool! Since you have decided that we're going to use prismlibrary.github.io, could I start a rough prototype?
Hi @eriawan , I already created a mockup. @brianlagunas , please let me know what do you think about it on this link in real size mockup:
preview.riandesign.com.br/prismlibrary
Where "Learn" page will have subpages such as Videos and Pluralsight courses. And "Discuss" can have subpages like Blogs, Slack channel, Report bugs (external link), Twitter etc.
I also attached its image below. If you want any changes or want something different, please tell me.
@riandesign looks great. Maybe we should add a mention to the NuGet packages as an alternative way to use Prism?
@riandesign dude! This is beautiful! I love it. You rock!
Also, I agree with @bartlannoeye, but we can figure out the content as we go. The layout is great.
@brianlagunas @bartlannoeye I'm glad you liked it! Maybe something like this?
Well, I am actually thinking that the content area for "Setup the Prism Source Code" should be more of a "Getting Started".
Step 1 - Install the Template Pack (small screenshot of template pack ) Step 2 - Create a Project (small screenshot of the project templates) Step 3 - Run the code. (small screenshot of running app, preferably a mobile app)
Something like that, but show "Fast and Easy" type of stuff. More thought probably need to go into it, but something along the lines of how easy it is to start writing Prism apps.
I'm not sure about the NuGet section. Something just seems a little off. I can't put my finger on it yet.
Another thing I would like to highlight is our Slack channel. Maybe right under the main section. "Join our Slack Channel" or something. Not sure.
For "getting started" maybe "Quick start", because it is quick.. And you need to put "BOOM!" in there as well, its the part of Brian's demos that I love :)
@riandesign looks really good!
@riandesign great! we should use this design as our starting visual design for the Prism website.
@brianlagunas , please let me know what you think about this mockup in the link below. Did I forget something?
looks great!
Nice. So, I'll develop it, ok? About the content, texts etc, when you have them, could you send them to my email, please?
Yes, please develop it. For now you can use the text you have. When you check it into the website repo, I will update the text. This way you don't have to wait on me for anything.
@brianlagunas , do you have a server already? Where will we host it?
PS: the website is not developed yet.
Hosting is done on GitHub pages. Simply send a PR to this repository: https://github.com/PrismLibrary/prismlibrary.github.io
I was attempting to look at what's in the "docs" folder via github.io and was not able to see a deployed version of all the nice docs in this repository.
Has it been setup to use the folder? https://github.com/blog/2228-simpler-github-pages-publishing
Would it be a bad idea to let what's in there now be seen? Minimally styled with what's already there?
@garrypolley on the readme file there is a link to the docs: http://prismlibrary.readthedocs.io/en/latest/
We do not have a website yet.
Yes, I'm still developing it. I'm doing at my free time, but I'll finish it probably in a couple weeks, ok? Anything you want, please tell me.
@riandesign no hurry. I understand you are doing this on your limited free time and we appreciate your effort.
Have you made any progress on this yet?
@brianlagunas sorry this huge delay! I'll finish it probably next week, ok? As soon as it's done I put it online. By the way, how can I send the files to you?
@riandesign you can send a PR to https://github.com/PrismLibrary/prismlibrary.github.io
You can also email them to me directly. Just let me know when you are done. Thanks.
@brianlagunas , I just sent a PR to https://github.com/PrismLibrary/prismlibrary.github.io Please, let me know if I did right, ok?
Note: the homepage is done, but the internal pages (Documentation, Learn, Discuss) are under construction, because I'm not sure what is the content for those pages.
Can you tell me or send me the content just to create a layout for them and put in there? After that, you'll be able to update the content easily, if you want it.
@brianlagunas I updated the files. Please, let me know if I did correctly.
On Fri, 26 May 2017 at 10:44 PM, Brian Lagunas notifications@github.com wrote:
Closed #411 https://github.com/PrismLibrary/Prism/issues/411.
— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/PrismLibrary/Prism/issues/411#event-1099270679, or mute the thread https://github.com/notifications/unsubscribe-auth/AF2BewNb_yWIaif11ejm23LHapuzxMNqks5r9whxgaJpZM4HI-hf .
-- Hi,
Thanks & Regards Thirukumaran
This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
We need to create a website that is hosted on our GitHub Pages repo:
https://github.com/PrismLibrary/prismlibrary.github.io
Nothing too fancy, just a clean and simple site. We can start with a single page for now, and then add navigation later on.